scale-gp-beta 0.1.0a40__py3-none-any.whl → 0.1.0a42__py3-none-any.whl

scale_gp_beta/resources/build.py

@@ -0,0 +1,588 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Mapping, cast
+from typing_extensions import Literal
+
+import httpx
+
+from ..types import build_list_params, build_create_params
+from .._types import Body, Omit, Query, Headers, NotGiven, FileTypes, omit, not_given
+from .._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._streaming import Stream, AsyncStream
+from ..pagination import SyncCursorPage, AsyncCursorPage
+from .._base_client import AsyncPaginator, make_request_options
+from ..types.stream_chunk import StreamChunk
+from ..types.build_list_response import BuildListResponse
+from ..types.build_cancel_response import BuildCancelResponse
+from ..types.build_create_response import BuildCreateResponse
+from ..types.build_retrieve_response import BuildRetrieveResponse
+
+__all__ = ["BuildResource", "AsyncBuildResource"]
+
+
+class BuildResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> BuildResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/scaleapi/sgp-python-beta#accessing-raw-response-data-eg-headers
+        """
+        return BuildResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> BuildResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/scaleapi/sgp-python-beta#with_streaming_response
+        """
+        return BuildResourceWithStreamingResponse(self)
+
+    def create(
+        self,
+        *,
+        context_archive: FileTypes,
+        image_name: str,
+        build_args: str | Omit = omit,
+        image_tag: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BuildCreateResponse:
+        """
+        Submit a container image build.
+
+        Upload a tar.gz archive containing the build context (Dockerfile and any files
+        needed for the build) along with image name, tag, and optional build arguments.
+
+        Maximum file size: 500MB
+
+        Args:
+          context_archive: tar.gz archive containing the build context (Dockerfile and any files needed for
+              the build)
+
+          image_name: Name for the built image
+
+          build_args: JSON string of build arguments
+
+          image_tag: Tag for the built image
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        body = deepcopy_minimal(
+            {
+                "context_archive": context_archive,
+                "image_name": image_name,
+                "build_args": build_args,
+                "image_tag": image_tag,
+            }
+        )
+        files = extract_files(cast(Mapping[str, object], body), paths=[["context_archive"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
+        return self._post(
+            "/v5/builds",
+            body=maybe_transform(body, build_create_params.BuildCreateParams),
+            files=files,
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BuildCreateResponse,
+        )
+
+    def retrieve(
+        self,
+        build_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BuildRetrieveResponse:
+        """
+        Get a build by ID, including current status from the cloud provider.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not build_id:
+            raise ValueError(f"Expected a non-empty value for `build_id` but received {build_id!r}")
+        return self._get(
+            f"/v5/builds/{build_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BuildRetrieveResponse,
+        )
+
+    def list(
+        self,
+        *,
+        ending_before: str | Omit = omit,
+        limit: int | Omit = omit,
+        sort_by: str | Omit = omit,
+        sort_order: Literal["asc", "desc"] | Omit = omit,
+        starting_after: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SyncCursorPage[BuildListResponse]:
+        """
+        List Builds
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get_api_list(
+            "/v5/builds",
+            page=SyncCursorPage[BuildListResponse],
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "ending_before": ending_before,
+                        "limit": limit,
+                        "sort_by": sort_by,
+                        "sort_order": sort_order,
+                        "starting_after": starting_after,
+                    },
+                    build_list_params.BuildListParams,
+                ),
+            ),
+            model=BuildListResponse,
+        )
+
+    def cancel(
+        self,
+        build_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BuildCancelResponse:
+        """
+        Cancel a pending or running build.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not build_id:
+            raise ValueError(f"Expected a non-empty value for `build_id` but received {build_id!r}")
+        return self._post(
+            f"/v5/builds/{build_id}/cancel",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BuildCancelResponse,
+        )
+
+    def logs(
+        self,
+        build_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Stream[StreamChunk]:
+        """
+        Stream build logs via Server-Sent Events (SSE).
+
+        Returns a streaming response with content-type text/event-stream. Each log line
+        is sent as an SSE data event.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not build_id:
+            raise ValueError(f"Expected a non-empty value for `build_id` but received {build_id!r}")
+        return self._get(
+            f"/v5/builds/{build_id}/logs",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=StreamChunk,
+            stream=True,
+            stream_cls=Stream[StreamChunk],
+        )
+
+
+class AsyncBuildResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncBuildResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/scaleapi/sgp-python-beta#accessing-raw-response-data-eg-headers
+        """
+        return AsyncBuildResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncBuildResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/scaleapi/sgp-python-beta#with_streaming_response
+        """
+        return AsyncBuildResourceWithStreamingResponse(self)
+
+    async def create(
+        self,
+        *,
+        context_archive: FileTypes,
+        image_name: str,
+        build_args: str | Omit = omit,
+        image_tag: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BuildCreateResponse:
+        """
+        Submit a container image build.
+
+        Upload a tar.gz archive containing the build context (Dockerfile and any files
+        needed for the build) along with image name, tag, and optional build arguments.
+
+        Maximum file size: 500MB
+
+        Args:
+          context_archive: tar.gz archive containing the build context (Dockerfile and any files needed for
+              the build)
+
+          image_name: Name for the built image
+
+          build_args: JSON string of build arguments
+
+          image_tag: Tag for the built image
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        body = deepcopy_minimal(
+            {
+                "context_archive": context_archive,
+                "image_name": image_name,
+                "build_args": build_args,
+                "image_tag": image_tag,
+            }
+        )
+        files = extract_files(cast(Mapping[str, object], body), paths=[["context_archive"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
+        return await self._post(
+            "/v5/builds",
+            body=await async_maybe_transform(body, build_create_params.BuildCreateParams),
+            files=files,
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BuildCreateResponse,
+        )
+
+    async def retrieve(
+        self,
+        build_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BuildRetrieveResponse:
+        """
+        Get a build by ID, including current status from the cloud provider.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not build_id:
+            raise ValueError(f"Expected a non-empty value for `build_id` but received {build_id!r}")
+        return await self._get(
+            f"/v5/builds/{build_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BuildRetrieveResponse,
+        )
+
+    def list(
+        self,
+        *,
+        ending_before: str | Omit = omit,
+        limit: int | Omit = omit,
+        sort_by: str | Omit = omit,
+        sort_order: Literal["asc", "desc"] | Omit = omit,
+        starting_after: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AsyncPaginator[BuildListResponse, AsyncCursorPage[BuildListResponse]]:
+        """
+        List Builds
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get_api_list(
+            "/v5/builds",
+            page=AsyncCursorPage[BuildListResponse],
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "ending_before": ending_before,
+                        "limit": limit,
+                        "sort_by": sort_by,
+                        "sort_order": sort_order,
+                        "starting_after": starting_after,
+                    },
+                    build_list_params.BuildListParams,
+                ),
+            ),
+            model=BuildListResponse,
+        )
+
+    async def cancel(
+        self,
+        build_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BuildCancelResponse:
+        """
+        Cancel a pending or running build.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not build_id:
+            raise ValueError(f"Expected a non-empty value for `build_id` but received {build_id!r}")
+        return await self._post(
+            f"/v5/builds/{build_id}/cancel",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BuildCancelResponse,
+        )
+
+    async def logs(
+        self,
+        build_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AsyncStream[StreamChunk]:
+        """
+        Stream build logs via Server-Sent Events (SSE).
+
+        Returns a streaming response with content-type text/event-stream. Each log line
+        is sent as an SSE data event.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not build_id:
+            raise ValueError(f"Expected a non-empty value for `build_id` but received {build_id!r}")
+        return await self._get(
+            f"/v5/builds/{build_id}/logs",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=StreamChunk,
+            stream=True,
+            stream_cls=AsyncStream[StreamChunk],
+        )
+
+
+class BuildResourceWithRawResponse:
+    def __init__(self, build: BuildResource) -> None:
+        self._build = build
+
+        self.create = to_raw_response_wrapper(
+            build.create,
+        )
+        self.retrieve = to_raw_response_wrapper(
+            build.retrieve,
+        )
+        self.list = to_raw_response_wrapper(
+            build.list,
+        )
+        self.cancel = to_raw_response_wrapper(
+            build.cancel,
+        )
+        self.logs = to_raw_response_wrapper(
+            build.logs,
+        )
+
+
+class AsyncBuildResourceWithRawResponse:
+    def __init__(self, build: AsyncBuildResource) -> None:
+        self._build = build
+
+        self.create = async_to_raw_response_wrapper(
+            build.create,
+        )
+        self.retrieve = async_to_raw_response_wrapper(
+            build.retrieve,
+        )
+        self.list = async_to_raw_response_wrapper(
+            build.list,
+        )
+        self.cancel = async_to_raw_response_wrapper(
+            build.cancel,
+        )
+        self.logs = async_to_raw_response_wrapper(
+            build.logs,
+        )
+
+
+class BuildResourceWithStreamingResponse:
+    def __init__(self, build: BuildResource) -> None:
+        self._build = build
+
+        self.create = to_streamed_response_wrapper(
+            build.create,
+        )
+        self.retrieve = to_streamed_response_wrapper(
+            build.retrieve,
+        )
+        self.list = to_streamed_response_wrapper(
+            build.list,
+        )
+        self.cancel = to_streamed_response_wrapper(
+            build.cancel,
+        )
+        self.logs = to_streamed_response_wrapper(
+            build.logs,
+        )
+
+
+class AsyncBuildResourceWithStreamingResponse:
+    def __init__(self, build: AsyncBuildResource) -> None:
+        self._build = build
+
+        self.create = async_to_streamed_response_wrapper(
+            build.create,
+        )
+        self.retrieve = async_to_streamed_response_wrapper(
+            build.retrieve,
+        )
+        self.list = async_to_streamed_response_wrapper(
+            build.list,
+        )
+        self.cancel = async_to_streamed_response_wrapper(
+            build.cancel,
+        )
+        self.logs = async_to_streamed_response_wrapper(
+            build.logs,
+        )

scale_gp_beta/types/__init__.py

@@ -19,6 +19,7 @@ from .evaluation import Evaluation as Evaluation
 from .span_status import SpanStatus as SpanStatus
 from .dataset_item import DatasetItem as DatasetItem
 from .item_locator import ItemLocator as ItemLocator
+from .stream_chunk import StreamChunk as StreamChunk
 from .approval_status import ApprovalStatus as ApprovalStatus
 from .assessment_type import AssessmentType as AssessmentType
 from .component_param import ComponentParam as ComponentParam
@@ -28,6 +29,7 @@ from .evaluation_task import EvaluationTask as EvaluationTask
 from .inference_model import InferenceModel as InferenceModel
 from .span_assessment import SpanAssessment as SpanAssessment
 from .file_list_params import FileListParams as FileListParams
+from .build_list_params import BuildListParams as BuildListParams
 from .credential_secret import CredentialSecret as CredentialSecret
 from .model_list_params import ModelListParams as ModelListParams
 from .span_batch_params import SpanBatchParams as SpanBatchParams
@@ -37,12 +39,16 @@ from .inference_response import InferenceResponse as InferenceResponse
 from .span_create_params import SpanCreateParams as SpanCreateParams
 from .span_search_params import SpanSearchParams as SpanSearchParams
 from .span_update_params import SpanUpdateParams as SpanUpdateParams
+from .build_create_params import BuildCreateParams as BuildCreateParams
+from .build_list_response import BuildListResponse as BuildListResponse
 from .dataset_list_params import DatasetListParams as DatasetListParams
 from .model_create_params import ModelCreateParams as ModelCreateParams
 from .model_update_params import ModelUpdateParams as ModelUpdateParams
 from .span_batch_response import SpanBatchResponse as SpanBatchResponse
 from .file_delete_response import FileDeleteResponse as FileDeleteResponse
 from .question_list_params import QuestionListParams as QuestionListParams
+from .build_cancel_response import BuildCancelResponse as BuildCancelResponse
+from .build_create_response import BuildCreateResponse as BuildCreateResponse
 from .dataset_create_params import DatasetCreateParams as DatasetCreateParams
 from .dataset_update_params import DatasetUpdateParams as DatasetUpdateParams
 from .evaluation_task_param import EvaluationTaskParam as EvaluationTaskParam
@@ -52,6 +58,7 @@ from .credential_list_params import CredentialListParams as CredentialListParams
 from .evaluation_list_params import EvaluationListParams as EvaluationListParams
 from .question_create_params import QuestionCreateParams as QuestionCreateParams
 from .response_create_params import ResponseCreateParams as ResponseCreateParams
+from .build_retrieve_response import BuildRetrieveResponse as BuildRetrieveResponse
 from .dataset_delete_response import DatasetDeleteResponse as DatasetDeleteResponse
 from .dataset_retrieve_params import DatasetRetrieveParams as DatasetRetrieveParams
 from .inference_create_params import InferenceCreateParams as InferenceCreateParams

scale_gp_beta/types/build_cancel_response.py

@@ -0,0 +1,38 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .shared.identity import Identity
+
+__all__ = ["BuildCancelResponse"]
+
+
+class BuildCancelResponse(BaseModel):
+    account_id: str
+
+    build_id: str
+
+    created_at: datetime
+
+    created_by: Identity
+    """The identity that created the entity."""
+
+    image_name: str
+
+    image_tag: str
+
+    image_url: str
+
+    status: str
+    """The current build status from the cloud provider"""
+
+    build_end_time: Optional[datetime] = None
+    """When the cloud provider finished the build"""
+
+    build_start_time: Optional[datetime] = None
+    """When the cloud provider started the build"""
+
+    object: Optional[Literal["agentex_cloud_build"]] = None

scale_gp_beta/types/build_create_params.py

@@ -0,0 +1,26 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+from .._types import FileTypes
+
+__all__ = ["BuildCreateParams"]
+
+
+class BuildCreateParams(TypedDict, total=False):
+    context_archive: Required[FileTypes]
+    """
+    tar.gz archive containing the build context (Dockerfile and any files needed for
+    the build)
+    """
+
+    image_name: Required[str]
+    """Name for the built image"""
+
+    build_args: str
+    """JSON string of build arguments"""
+
+    image_tag: str
+    """Tag for the built image"""