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

opencode/resources/location.py

@@ -0,0 +1,160 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``location`` resource."""
+
+from __future__ import annotations
+
+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,
+    LocationPublicInfo,
+)
+
+__all__ = ["LocationResource", "AsyncLocationResource"]
+
+
+class LocationResource(SyncAPIResource):
+    """Operations under ``client.location`` (OpenCode ``location``)."""
+
+    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,
+    ) -> LocationPublicInfo:
+        """Get location.
+
+        Resolve the requested location or the server default location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/location``
+        """
+        return cast(
+            "LocationPublicInfo",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/location",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=LocationPublicInfo,
+            ),
+        )
+
+    def reload(
+        self,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Reload configuration.
+
+        Shut down and rebuild every loaded location. Pending permissions and forms are cancelled; running sessions continue with fresh services at the next step boundary. Emits location.shutdown for client recovery and responds once all replacement builds settle.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          ServiceUnavailableError
+
+        ``POST /api/location/reload``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path="/api/location/reload",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class AsyncLocationResource(AsyncAPIResource):
+    """Operations under ``client.location`` (OpenCode ``location``)."""
+
+    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,
+    ) -> LocationPublicInfo:
+        """Get location.
+
+        Resolve the requested location or the server default location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/location``
+        """
+        return cast(
+            "LocationPublicInfo",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/location",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=LocationPublicInfo,
+            ),
+        )
+
+    async def reload(
+        self,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Reload configuration.
+
+        Shut down and rebuild every loaded location. Pending permissions and forms are cancelled; running sessions continue with fresh services at the next step boundary. Emits location.shutdown for client recovery and responds once all replacement builds settle.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          ServiceUnavailableError
+
+        ``POST /api/location/reload``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path="/api/location/reload",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )

opencode/resources/mcp.py

@@ -0,0 +1,488 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``mcp`` resource."""
+
+from __future__ import annotations
+
+from functools import cached_property
+from typing import cast
+
+from .._base_client import RequestOptions
+from .._qs import encode_path_segment
+from .._resource import AsyncAPIResource, SyncAPIResource
+from .._types import NOT_GIVEN, Body, Headers, NotGiven, Query, Timeout
+from ..types import (
+    Location,
+    McpAddConfig,
+    McpListResponse,
+    McpResourceCatalogResponse,
+)
+
+__all__ = ["McpResource", "AsyncMcpResource"]
+
+
+class McpResourceResource(SyncAPIResource):
+    """Operations under ``client.mcp.resource`` (OpenCode ``mcp.resource``)."""
+
+    def catalog(
+        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,
+    ) -> McpResourceCatalogResponse:
+        """List MCP resources.
+
+        Retrieve resources and resource templates from connected MCP servers.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/mcp/resource``
+        """
+        return cast(
+            "McpResourceCatalogResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/mcp/resource",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=McpResourceCatalogResponse,
+            ),
+        )
+
+
+class McpResource(SyncAPIResource):
+    """Operations under ``client.mcp`` (OpenCode ``mcp``)."""
+
+    @cached_property
+    def resource(self) -> McpResourceResource:
+        return McpResourceResource(self._client)
+
+    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,
+    ) -> McpListResponse:
+        """List MCP servers.
+
+        Retrieve configured MCP servers and their connection status.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/mcp``
+        """
+        return cast(
+            "McpListResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/mcp",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=McpListResponse,
+            ),
+        )
+
+    def add(
+        self,
+        server: str,
+        *,
+        config: McpAddConfig,
+        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,
+    ) -> None:
+        """Add MCP server.
+
+        Add an MCP server at runtime or replace an existing one, connecting it immediately.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``PUT /api/experimental/mcp/:server``
+        """
+        self._client.request(
+            RequestOptions(
+                method="PUT",
+                path=f"/api/experimental/mcp/{encode_path_segment(server)}",
+                query={"location": self._location(location)},
+                body={"config": config},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def remove(
+        self,
+        server: str,
+        *,
+        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,
+    ) -> None:
+        """Remove MCP server.
+
+        Stop an MCP server and remove it from the runtime set until restart.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          McpServerNotFoundError
+          LocationNotFoundError
+
+        ``DELETE /api/experimental/mcp/:server``
+        """
+        self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/experimental/mcp/{encode_path_segment(server)}",
+                query={"location": self._location(location)},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def connect(
+        self,
+        server: str,
+        *,
+        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,
+    ) -> None:
+        """Connect MCP server.
+
+        Connect an MCP server at runtime, overriding a disabled configuration until restart.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          McpServerNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/experimental/mcp/:server/connect``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/experimental/mcp/{encode_path_segment(server)}/connect",
+                query={"location": self._location(location)},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def disconnect(
+        self,
+        server: str,
+        *,
+        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,
+    ) -> None:
+        """Disconnect MCP server.
+
+        Disconnect an MCP server at runtime, removing its tools until reconnected.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          McpServerNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/experimental/mcp/:server/disconnect``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/experimental/mcp/{encode_path_segment(server)}/disconnect",
+                query={"location": self._location(location)},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class AsyncMcpResourceResource(AsyncAPIResource):
+    """Operations under ``client.mcp.resource`` (OpenCode ``mcp.resource``)."""
+
+    async def catalog(
+        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,
+    ) -> McpResourceCatalogResponse:
+        """List MCP resources.
+
+        Retrieve resources and resource templates from connected MCP servers.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/mcp/resource``
+        """
+        return cast(
+            "McpResourceCatalogResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/mcp/resource",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=McpResourceCatalogResponse,
+            ),
+        )
+
+
+class AsyncMcpResource(AsyncAPIResource):
+    """Operations under ``client.mcp`` (OpenCode ``mcp``)."""
+
+    @cached_property
+    def resource(self) -> AsyncMcpResourceResource:
+        return AsyncMcpResourceResource(self._client)
+
+    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,
+    ) -> McpListResponse:
+        """List MCP servers.
+
+        Retrieve configured MCP servers and their connection status.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/mcp``
+        """
+        return cast(
+            "McpListResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/mcp",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=McpListResponse,
+            ),
+        )
+
+    async def add(
+        self,
+        server: str,
+        *,
+        config: McpAddConfig,
+        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,
+    ) -> None:
+        """Add MCP server.
+
+        Add an MCP server at runtime or replace an existing one, connecting it immediately.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``PUT /api/experimental/mcp/:server``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="PUT",
+                path=f"/api/experimental/mcp/{encode_path_segment(server)}",
+                query={"location": self._location(location)},
+                body={"config": config},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def remove(
+        self,
+        server: str,
+        *,
+        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,
+    ) -> None:
+        """Remove MCP server.
+
+        Stop an MCP server and remove it from the runtime set until restart.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          McpServerNotFoundError
+          LocationNotFoundError
+
+        ``DELETE /api/experimental/mcp/:server``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/experimental/mcp/{encode_path_segment(server)}",
+                query={"location": self._location(location)},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def connect(
+        self,
+        server: str,
+        *,
+        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,
+    ) -> None:
+        """Connect MCP server.
+
+        Connect an MCP server at runtime, overriding a disabled configuration until restart.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          McpServerNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/experimental/mcp/:server/connect``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/experimental/mcp/{encode_path_segment(server)}/connect",
+                query={"location": self._location(location)},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def disconnect(
+        self,
+        server: str,
+        *,
+        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,
+    ) -> None:
+        """Disconnect MCP server.
+
+        Disconnect an MCP server at runtime, removing its tools until reconnected.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          McpServerNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/experimental/mcp/:server/disconnect``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/experimental/mcp/{encode_path_segment(server)}/disconnect",
+                query={"location": self._location(location)},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )