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

opencode/resources/vcs.py

@@ -0,0 +1,496 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``vcs`` resource."""
+
+from __future__ import annotations
+
+from functools import cached_property
+from typing import cast
+
+from .._base_client import RequestOptions
+from .._resource import AsyncAPIResource, SyncAPIResource
+from .._types import NOT_GIVEN, Body, Headers, NotGiven, Query, Timeout
+from ..types import (
+    Location,
+    VcsBaseResponse,
+    VcsBranchListResponse,
+    VcsDiffResponse,
+    VcsGetResponse,
+    VcsMode,
+    VcsStatusResponse,
+)
+
+__all__ = ["VcsResource", "AsyncVcsResource"]
+
+
+class VcsBranchResource(SyncAPIResource):
+    """Operations under ``client.vcs.branch`` (OpenCode ``vcs.branch``)."""
+
+    def list(
+        self,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        search: str | NotGiven | None = NOT_GIVEN,
+        limit: 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,
+    ) -> VcsBranchListResponse:
+        """VCS branches.
+
+        List local and remote branches available at the requested location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/vcs/branch``
+        """
+        return cast(
+            "VcsBranchListResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/vcs/branch",
+                    query={"location": self._location(location), "search": search, "limit": limit},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VcsBranchListResponse,
+            ),
+        )
+
+
+class VcsResource(SyncAPIResource):
+    """Operations under ``client.vcs`` (OpenCode ``vcs``)."""
+
+    @cached_property
+    def branch(self) -> VcsBranchResource:
+        return VcsBranchResource(self._client)
+
+    def init(
+        self,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        provider: 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:
+        """Initialize VCS repository.
+
+        Initialize a repository using the selected VCS provider in a markerless project's directory and refresh its location services. Omitting provider defaults to git; built-in git and hg providers support initialization. An unknown provider returns 400; a registered provider without init returns 501.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          ConflictError
+          VcsInitNotSupportedError
+          ServiceUnavailableError
+
+        ``POST /api/vcs/init``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path="/api/vcs/init",
+                query={"location": self._location(location), "provider": provider},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def get(
+        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,
+    ) -> VcsGetResponse:
+        """VCS info.
+
+        Get current and default branch information for the requested location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/vcs``
+        """
+        return cast(
+            "VcsGetResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/vcs",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VcsGetResponse,
+            ),
+        )
+
+    def base(
+        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,
+    ) -> VcsBaseResponse:
+        """VCS review base.
+
+        Infer a local review base from named branch creation history, or the repository default only when currently on that branch. Returns null before the first commit or when the provider lacks base metadata; ambiguous Git history requires an explicit base on diff requests.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``GET /api/vcs/base``
+        """
+        return cast(
+            "VcsBaseResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/vcs/base",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VcsBaseResponse,
+            ),
+        )
+
+    def status(
+        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,
+    ) -> VcsStatusResponse:
+        """VCS status.
+
+        List uncommitted working-copy changes relative to the requested location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/vcs/status``
+        """
+        return cast(
+            "VcsStatusResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/vcs/status",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VcsStatusResponse,
+            ),
+        )
+
+    def diff(
+        self,
+        *,
+        mode: VcsMode,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        base: str | 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,
+    ) -> VcsDiffResponse:
+        """VCS diff.
+
+        Diff HEAD to the working copy (working), the base merge-base to the working copy (branch), or the base merge-base to HEAD (committed). Omitting base preserves repository-default comparison; supplying it overrides the comparison without saving it.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``GET /api/vcs/diff``
+        """
+        return cast(
+            "VcsDiffResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/vcs/diff",
+                    query={"location": self._location(location), "mode": mode, "base": base, "context": context},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VcsDiffResponse,
+            ),
+        )
+
+
+class AsyncVcsBranchResource(AsyncAPIResource):
+    """Operations under ``client.vcs.branch`` (OpenCode ``vcs.branch``)."""
+
+    async def list(
+        self,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        search: str | NotGiven | None = NOT_GIVEN,
+        limit: 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,
+    ) -> VcsBranchListResponse:
+        """VCS branches.
+
+        List local and remote branches available at the requested location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/vcs/branch``
+        """
+        return cast(
+            "VcsBranchListResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/vcs/branch",
+                    query={"location": self._location(location), "search": search, "limit": limit},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VcsBranchListResponse,
+            ),
+        )
+
+
+class AsyncVcsResource(AsyncAPIResource):
+    """Operations under ``client.vcs`` (OpenCode ``vcs``)."""
+
+    @cached_property
+    def branch(self) -> AsyncVcsBranchResource:
+        return AsyncVcsBranchResource(self._client)
+
+    async def init(
+        self,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        provider: 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:
+        """Initialize VCS repository.
+
+        Initialize a repository using the selected VCS provider in a markerless project's directory and refresh its location services. Omitting provider defaults to git; built-in git and hg providers support initialization. An unknown provider returns 400; a registered provider without init returns 501.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          ConflictError
+          VcsInitNotSupportedError
+          ServiceUnavailableError
+
+        ``POST /api/vcs/init``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path="/api/vcs/init",
+                query={"location": self._location(location), "provider": provider},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def get(
+        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,
+    ) -> VcsGetResponse:
+        """VCS info.
+
+        Get current and default branch information for the requested location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/vcs``
+        """
+        return cast(
+            "VcsGetResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/vcs",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VcsGetResponse,
+            ),
+        )
+
+    async def base(
+        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,
+    ) -> VcsBaseResponse:
+        """VCS review base.
+
+        Infer a local review base from named branch creation history, or the repository default only when currently on that branch. Returns null before the first commit or when the provider lacks base metadata; ambiguous Git history requires an explicit base on diff requests.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``GET /api/vcs/base``
+        """
+        return cast(
+            "VcsBaseResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/vcs/base",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VcsBaseResponse,
+            ),
+        )
+
+    async def status(
+        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,
+    ) -> VcsStatusResponse:
+        """VCS status.
+
+        List uncommitted working-copy changes relative to the requested location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/vcs/status``
+        """
+        return cast(
+            "VcsStatusResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/vcs/status",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VcsStatusResponse,
+            ),
+        )
+
+    async def diff(
+        self,
+        *,
+        mode: VcsMode,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        base: str | 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,
+    ) -> VcsDiffResponse:
+        """VCS diff.
+
+        Diff HEAD to the working copy (working), the base merge-base to the working copy (branch), or the base merge-base to HEAD (committed). Omitting base preserves repository-default comparison; supplying it overrides the comparison without saving it.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``GET /api/vcs/diff``
+        """
+        return cast(
+            "VcsDiffResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/vcs/diff",
+                    query={"location": self._location(location), "mode": mode, "base": base, "context": context},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VcsDiffResponse,
+            ),
+        )

opencode/resources/voice.py

@@ -0,0 +1,111 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``voice`` resource."""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, cast
+
+from .._base_client import RequestOptions
+from .._resource import AsyncAPIResource, SyncAPIResource
+from .._types import NOT_GIVEN, Body, Headers, NotGiven, Query, Timeout
+from ..types import (
+    VoiceSessionResponseData,
+    VoiceTransportInput,
+)
+
+__all__ = ["VoiceResource", "AsyncVoiceResource"]
+
+
+class VoiceResource(SyncAPIResource):
+    """Operations under ``client.voice`` (OpenCode ``voice``)."""
+
+    def session(
+        self,
+        *,
+        model: str,
+        transport: VoiceTransportInput,
+        session: Mapping[str, Any] | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> VoiceSessionResponseData:
+        """Create voice session.
+
+        Create a server-brokered voice session using the server's configured provider credentials and return the WebRTC SDP answer or WebSocket ephemeral token.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``POST /api/experimental/voice/session``
+        """
+        return cast(
+            "VoiceSessionResponseData",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/experimental/voice/session",
+                    body={"model": model, "session": session, "transport": transport},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VoiceSessionResponseData,
+                unwrap=True,
+            ),
+        )
+
+
+class AsyncVoiceResource(AsyncAPIResource):
+    """Operations under ``client.voice`` (OpenCode ``voice``)."""
+
+    async def session(
+        self,
+        *,
+        model: str,
+        transport: VoiceTransportInput,
+        session: Mapping[str, Any] | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> VoiceSessionResponseData:
+        """Create voice session.
+
+        Create a server-brokered voice session using the server's configured provider credentials and return the WebRTC SDP answer or WebSocket ephemeral token.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``POST /api/experimental/voice/session``
+        """
+        return cast(
+            "VoiceSessionResponseData",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/experimental/voice/session",
+                    body={"model": model, "session": session, "transport": transport},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=VoiceSessionResponseData,
+                unwrap=True,
+            ),
+        )