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

opencode/resources/file.py

@@ -0,0 +1,353 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``file`` resource."""
+
+from __future__ import annotations
+
+from typing import Literal, cast
+
+from .._base_client import RequestOptions
+from .._qs import encode_path
+from .._resource import AsyncAPIResource, SyncAPIResource
+from .._types import NOT_GIVEN, Body, Headers, NotGiven, OpenEnum, Query, Timeout
+from ..types import (
+    FileFindResponse,
+    FileListResponse,
+    FileWriteResponse,
+    Location,
+)
+
+__all__ = ["FileResource", "AsyncFileResource"]
+
+
+class FileResource(SyncAPIResource):
+    """Operations under ``client.file`` (OpenCode ``file``)."""
+
+    def read(
+        self,
+        path: 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,
+    ) -> bytes:
+        """Read file.
+
+        Stream one file relative to the requested location with ETag, Last-Modified, and single-range HTTP Range support (206 Partial Content, 416 Range Not Satisfiable, and 304 Not Modified; multi-range and malformed Range headers fall back to 200).
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          RemoteFileNotFoundError
+          LocationNotFoundError
+
+        ``GET /api/fs/read/*``
+        """
+        return cast(
+            "bytes",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/fs/read/{encode_path(path)}",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                kind="binary",
+            ),
+        )
+
+    def list(
+        self,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        path: 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,
+    ) -> FileListResponse:
+        """List directory.
+
+        List direct children using an absolute path or a path relative to the requested location, including parents and siblings outside its directory. Entry paths remain relative to the requested location; listing does not switch locations.
+
+        Args:
+          path: An absolute path or a path relative to the requested location. Defaults to the location directory.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          RemoteFileNotFoundError
+          LocationNotFoundError
+
+        ``GET /api/fs/list``
+        """
+        return cast(
+            "FileListResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/fs/list",
+                    query={"location": self._location(location), "path": path},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FileListResponse,
+            ),
+        )
+
+    def find(
+        self,
+        *,
+        query: str,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        type: OpenEnum[Literal["file", "directory"]] | 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,
+    ) -> FileFindResponse:
+        """Find files.
+
+        Find recursively ranked filesystem entries relative to the requested location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/fs/find``
+        """
+        return cast(
+            "FileFindResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/fs/find",
+                    query={"location": self._location(location), "query": query, "type": type, "limit": limit},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FileFindResponse,
+            ),
+        )
+
+    def write(
+        self,
+        *,
+        path: str,
+        payload: bytes,
+        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,
+    ) -> FileWriteResponse:
+        """Write file.
+
+        Write the raw request body to an absolute path or a path relative to the requested location, creating parent directories, and return the resolved absolute path. Unlike read, the target is not confined to the location. Experimental: may change without compatibility guarantees.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Args:
+          path: An absolute path or a path relative to the requested location. Missing parent directories are created.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``POST /api/experimental/fs/write``
+        """
+        return cast(
+            "FileWriteResponse",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/experimental/fs/write",
+                    query={"location": self._location(location), "path": path},
+                    content=bytes(payload),
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FileWriteResponse,
+            ),
+        )
+
+
+class AsyncFileResource(AsyncAPIResource):
+    """Operations under ``client.file`` (OpenCode ``file``)."""
+
+    async def read(
+        self,
+        path: 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,
+    ) -> bytes:
+        """Read file.
+
+        Stream one file relative to the requested location with ETag, Last-Modified, and single-range HTTP Range support (206 Partial Content, 416 Range Not Satisfiable, and 304 Not Modified; multi-range and malformed Range headers fall back to 200).
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          RemoteFileNotFoundError
+          LocationNotFoundError
+
+        ``GET /api/fs/read/*``
+        """
+        return cast(
+            "bytes",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/fs/read/{encode_path(path)}",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                kind="binary",
+            ),
+        )
+
+    async def list(
+        self,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        path: 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,
+    ) -> FileListResponse:
+        """List directory.
+
+        List direct children using an absolute path or a path relative to the requested location, including parents and siblings outside its directory. Entry paths remain relative to the requested location; listing does not switch locations.
+
+        Args:
+          path: An absolute path or a path relative to the requested location. Defaults to the location directory.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          RemoteFileNotFoundError
+          LocationNotFoundError
+
+        ``GET /api/fs/list``
+        """
+        return cast(
+            "FileListResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/fs/list",
+                    query={"location": self._location(location), "path": path},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FileListResponse,
+            ),
+        )
+
+    async def find(
+        self,
+        *,
+        query: str,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        type: OpenEnum[Literal["file", "directory"]] | 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,
+    ) -> FileFindResponse:
+        """Find files.
+
+        Find recursively ranked filesystem entries relative to the requested location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/fs/find``
+        """
+        return cast(
+            "FileFindResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/fs/find",
+                    query={"location": self._location(location), "query": query, "type": type, "limit": limit},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FileFindResponse,
+            ),
+        )
+
+    async def write(
+        self,
+        *,
+        path: str,
+        payload: bytes,
+        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,
+    ) -> FileWriteResponse:
+        """Write file.
+
+        Write the raw request body to an absolute path or a path relative to the requested location, creating parent directories, and return the resolved absolute path. Unlike read, the target is not confined to the location. Experimental: may change without compatibility guarantees.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Args:
+          path: An absolute path or a path relative to the requested location. Missing parent directories are created.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``POST /api/experimental/fs/write``
+        """
+        return cast(
+            "FileWriteResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/experimental/fs/write",
+                    query={"location": self._location(location), "path": path},
+                    content=bytes(payload),
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FileWriteResponse,
+            ),
+        )

opencode/resources/form.py

@@ -0,0 +1,98 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``form`` 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 (
+    FormListResponse,
+    Location,
+)
+
+__all__ = ["FormResource", "AsyncFormResource"]
+
+
+class FormResource(SyncAPIResource):
+    """Operations under ``client.form`` (OpenCode ``form``)."""
+
+    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,
+    ) -> FormListResponse:
+        """List pending forms.
+
+        Retrieve pending forms for a location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/form``
+        """
+        return cast(
+            "FormListResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/form",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FormListResponse,
+            ),
+        )
+
+
+class AsyncFormResource(AsyncAPIResource):
+    """Operations under ``client.form`` (OpenCode ``form``)."""
+
+    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,
+    ) -> FormListResponse:
+        """List pending forms.
+
+        Retrieve pending forms for a location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+
+        ``GET /api/form``
+        """
+        return cast(
+            "FormListResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/form",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FormListResponse,
+            ),
+        )

opencode/resources/generate.py

@@ -0,0 +1,108 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``generate`` 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 (
+    GenerateTextResponseData,
+    ModelRef,
+)
+
+__all__ = ["GenerateResource", "AsyncGenerateResource"]
+
+
+class GenerateResource(SyncAPIResource):
+    """Operations under ``client.generate`` (OpenCode ``generate``)."""
+
+    def text(
+        self,
+        *,
+        prompt: str,
+        model: ModelRef | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> GenerateTextResponseData:
+        """Generate text.
+
+        Run one stateless model generation using the server's base configuration and return the assistant text. Uses the base configuration's default model when none is specified.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``POST /api/experimental/generate``
+        """
+        return cast(
+            "GenerateTextResponseData",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/experimental/generate",
+                    body={"prompt": prompt, "model": model},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=GenerateTextResponseData,
+                unwrap=True,
+            ),
+        )
+
+
+class AsyncGenerateResource(AsyncAPIResource):
+    """Operations under ``client.generate`` (OpenCode ``generate``)."""
+
+    async def text(
+        self,
+        *,
+        prompt: str,
+        model: ModelRef | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> GenerateTextResponseData:
+        """Generate text.
+
+        Run one stateless model generation using the server's base configuration and return the assistant text. Uses the base configuration's default model when none is specified.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``POST /api/experimental/generate``
+        """
+        return cast(
+            "GenerateTextResponseData",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/experimental/generate",
+                    body={"prompt": prompt, "model": model},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=GenerateTextResponseData,
+                unwrap=True,
+            ),
+        )