feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 90
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-9b2e136aedff0713e8d50d6c53a930cd2c3583dcac1a9fce552cf25bb0d29214.yml
-openapi_spec_hash: 81e1da702f2dfb28bbe1bfab0d5d8cbd
-config_hash: 5b2602a56850cf0d0e50da298d1c6916
+configured_endpoints: 91
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-034d0b86510db8b712b55ac88c1c4a322db2ce84edc632f6d27be1eb4f34fd37.yml
+openapi_spec_hash: 0485ec0d01253b2c1bdab3015370808e
+config_hash: 35e129f39a0c1fd38209b0dafb7c7562

api.md

@@ -45,12 +45,14 @@ Types:
 
 ```python
 from runloop_api_client.types import (
+    BlueprintBuildFromInspectionParameters,
     BlueprintBuildLog,
     BlueprintBuildLogsListView,
     BlueprintBuildParameters,
     BlueprintListView,
     BlueprintPreviewView,
     BlueprintView,
+    InspectionSource,
 )
 ```
 
@@ -298,6 +300,7 @@ Methods:
 - <code title="get /v1/repositories/{id}">client.repositories.<a href="./src/runloop_api_client/resources/repositories.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/repository_connection_view.py">RepositoryConnectionView</a></code>
 - <code title="get /v1/repositories">client.repositories.<a href="./src/runloop_api_client/resources/repositories.py">list</a>(\*\*<a href="src/runloop_api_client/types/repository_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/repository_connection_view.py">SyncRepositoriesCursorIDPage[RepositoryConnectionView]</a></code>
 - <code title="post /v1/repositories/{id}/delete">client.repositories.<a href="./src/runloop_api_client/resources/repositories.py">delete</a>(id) -> object</code>
+- <code title="post /v1/repositories/{id}/inspect">client.repositories.<a href="./src/runloop_api_client/resources/repositories.py">inspect</a>(id, \*\*<a href="src/runloop_api_client/types/repository_inspect_params.py">params</a>) -> <a href="./src/runloop_api_client/types/repository_inspection_details.py">RepositoryInspectionDetails</a></code>
 - <code title="get /v1/repositories/{id}/inspections">client.repositories.<a href="./src/runloop_api_client/resources/repositories.py">list_inspections</a>(id) -> <a href="./src/runloop_api_client/types/repository_inspection_list_view.py">RepositoryInspectionListView</a></code>
 - <code title="post /v1/repositories/{id}/refresh">client.repositories.<a href="./src/runloop_api_client/resources/repositories.py">refresh</a>(id, \*\*<a href="src/runloop_api_client/types/repository_refresh_params.py">params</a>) -> object</code>
 

src/runloop_api_client/resources/blueprints.py

@@ -29,6 +29,7 @@
 from ..lib.polling_async import async_poll_until
 from ..types.blueprint_view import BlueprintView
 from ..types.blueprint_preview_view import BlueprintPreviewView
+from ..types.inspection_source_param import InspectionSourceParam
 from ..types.blueprint_build_logs_list_view import BlueprintBuildLogsListView
 from ..types.shared_params.launch_parameters import LaunchParameters
 from ..types.shared_params.code_mount_parameters import CodeMountParameters
@@ -71,16 +72,11 @@ def with_streaming_response(self) -> BlueprintsResourceWithStreamingResponse:
     def create(
         self,
         *,
+        inspection_source: InspectionSourceParam,
         name: str,
-        base_blueprint_id: Optional[str] | Omit = omit,
-        base_blueprint_name: Optional[str] | Omit = omit,
-        build_args: Optional[Dict[str, str]] | Omit = omit,
-        code_mounts: Optional[Iterable[CodeMountParameters]] | Omit = omit,
-        dockerfile: Optional[str] | Omit = omit,
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
-        services: Optional[Iterable[blueprint_create_params.Service]] | Omit = omit,
         system_setup_commands: Optional[SequenceNotStr[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.
@@ -90,40 +86,23 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> BlueprintView:
-        """Starts build of custom defined container Blueprint.
-
-        The Blueprint will begin in
-        the 'provisioning' step and transition to the 'building' step once it is
-        selected off the build queue., Upon build complete it will transition to
-        'building_complete' if the build is successful.
+        """
+        Starts build of custom defined container Blueprint using a RepositoryConnection
+        Inspection as a source container specification.
 
         Args:
-          name: Name of the Blueprint.
-
-          base_blueprint_id: (Optional) ID of previously built blueprint to use as a base blueprint for this
-              build.
-
-          base_blueprint_name: (Optional) Name of previously built blueprint to use as a base blueprint for
-              this build. When set, this will load the latest successfully built Blueprint
-              with the given name. Only one of (base_blueprint_id, base_blueprint_name) should
-              be specified.
+          inspection_source: (Optional) Use a RepositoryInspection a source of a Blueprint build. The
+              Dockerfile will be automatically created based on the RepositoryInspection
+              contents.
 
-          build_args: (Optional) Arbitrary Docker build args to pass during build.
-
-          code_mounts: A list of code mounts to be included in the Blueprint.
-
-          dockerfile: Dockerfile contents to be used to build the Blueprint.
+          name: Name of the Blueprint.
 
           file_mounts: (Optional) Map of paths and file contents to write before setup.
 
           launch_parameters: Parameters to configure your Devbox at launch time.
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
-          services: (Optional) List of containerized services to include in the Blueprint. These
-              services will be pre-pulled during the build phase for optimized startup
-              performance.
-
           system_setup_commands: A list of commands to run to set up your system.
 
           extra_headers: Send extra headers
@@ -140,16 +119,11 @@ def create(
             "/v1/blueprints",
             body=maybe_transform(
                 {
+                    "inspection_source": inspection_source,
                     "name": name,
-                    "base_blueprint_id": base_blueprint_id,
-                    "base_blueprint_name": base_blueprint_name,
-                    "build_args": build_args,
-                    "code_mounts": code_mounts,
-                    "dockerfile": dockerfile,
                     "file_mounts": file_mounts,
                     "launch_parameters": launch_parameters,
                     "metadata": metadata,
-                    "services": services,
                     "system_setup_commands": system_setup_commands,
                 },
                 blueprint_create_params.BlueprintCreateParams,
@@ -596,16 +570,11 @@ def with_streaming_response(self) -> AsyncBlueprintsResourceWithStreamingRespons
     async def create(
         self,
         *,
+        inspection_source: InspectionSourceParam,
         name: str,
-        base_blueprint_id: Optional[str] | Omit = omit,
-        base_blueprint_name: Optional[str] | Omit = omit,
-        build_args: Optional[Dict[str, str]] | Omit = omit,
-        code_mounts: Optional[Iterable[CodeMountParameters]] | Omit = omit,
-        dockerfile: Optional[str] | Omit = omit,
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
-        services: Optional[Iterable[blueprint_create_params.Service]] | Omit = omit,
         system_setup_commands: Optional[SequenceNotStr[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.
@@ -615,40 +584,23 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> BlueprintView:
-        """Starts build of custom defined container Blueprint.
-
-        The Blueprint will begin in
-        the 'provisioning' step and transition to the 'building' step once it is
-        selected off the build queue., Upon build complete it will transition to
-        'building_complete' if the build is successful.
+        """
+        Starts build of custom defined container Blueprint using a RepositoryConnection
+        Inspection as a source container specification.
 
         Args:
-          name: Name of the Blueprint.
-
-          base_blueprint_id: (Optional) ID of previously built blueprint to use as a base blueprint for this
-              build.
-
-          base_blueprint_name: (Optional) Name of previously built blueprint to use as a base blueprint for
-              this build. When set, this will load the latest successfully built Blueprint
-              with the given name. Only one of (base_blueprint_id, base_blueprint_name) should
-              be specified.
+          inspection_source: (Optional) Use a RepositoryInspection a source of a Blueprint build. The
+              Dockerfile will be automatically created based on the RepositoryInspection
+              contents.
 
-          build_args: (Optional) Arbitrary Docker build args to pass during build.
-
-          code_mounts: A list of code mounts to be included in the Blueprint.
-
-          dockerfile: Dockerfile contents to be used to build the Blueprint.
+          name: Name of the Blueprint.
 
           file_mounts: (Optional) Map of paths and file contents to write before setup.
 
           launch_parameters: Parameters to configure your Devbox at launch time.
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
-          services: (Optional) List of containerized services to include in the Blueprint. These
-              services will be pre-pulled during the build phase for optimized startup
-              performance.
-
           system_setup_commands: A list of commands to run to set up your system.
 
           extra_headers: Send extra headers
@@ -665,16 +617,11 @@ async def create(
             "/v1/blueprints",
             body=await async_maybe_transform(
                 {
+                    "inspection_source": inspection_source,
                     "name": name,
-                    "base_blueprint_id": base_blueprint_id,
-                    "base_blueprint_name": base_blueprint_name,
-                    "build_args": build_args,
-                    "code_mounts": code_mounts,
-                    "dockerfile": dockerfile,
                     "file_mounts": file_mounts,
                     "launch_parameters": launch_parameters,
                     "metadata": metadata,
-                    "services": services,
                     "system_setup_commands": system_setup_commands,
                 },
                 blueprint_create_params.BlueprintCreateParams,

src/runloop_api_client/resources/repositories.py

@@ -6,7 +6,12 @@
 
 import httpx
 
-from ..types import repository_list_params, repository_create_params, repository_refresh_params
+from ..types import (
+    repository_list_params,
+    repository_create_params,
+    repository_inspect_params,
+    repository_refresh_params,
+)
 from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -20,6 +25,7 @@
 from ..pagination import SyncRepositoriesCursorIDPage, AsyncRepositoriesCursorIDPage
 from .._base_client import AsyncPaginator, make_request_options
 from ..types.repository_connection_view import RepositoryConnectionView
+from ..types.repository_inspection_details import RepositoryInspectionDetails
 from ..types.repository_inspection_list_view import RepositoryInspectionListView
 
 __all__ = ["RepositoriesResource", "AsyncRepositoriesResource"]
@@ -234,6 +240,60 @@ def delete(
             cast_to=object,
         )
 
+    def inspect(
+        self,
+        id: str,
+        *,
+        blueprint_id: Optional[str] | Omit = omit,
+        github_auth_token: Optional[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,
+        idempotency_key: str | None = None,
+    ) -> RepositoryInspectionDetails:
+        """
+        Inspect a repository connection by inspecting the specified version including
+        repo's technical stack and developer environment requirements.
+
+        Args:
+          blueprint_id: ID of blueprint to use as base for resulting RepositoryVersion blueprint.
+
+          github_auth_token: GitHub authentication token for accessing private repositories.
+
+          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
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._post(
+            f"/v1/repositories/{id}/inspect",
+            body=maybe_transform(
+                {
+                    "blueprint_id": blueprint_id,
+                    "github_auth_token": github_auth_token,
+                },
+                repository_inspect_params.RepositoryInspectParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=RepositoryInspectionDetails,
+        )
+
     def list_inspections(
         self,
         id: str,
@@ -532,6 +592,60 @@ async def delete(
             cast_to=object,
         )
 
+    async def inspect(
+        self,
+        id: str,
+        *,
+        blueprint_id: Optional[str] | Omit = omit,
+        github_auth_token: Optional[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,
+        idempotency_key: str | None = None,
+    ) -> RepositoryInspectionDetails:
+        """
+        Inspect a repository connection by inspecting the specified version including
+        repo's technical stack and developer environment requirements.
+
+        Args:
+          blueprint_id: ID of blueprint to use as base for resulting RepositoryVersion blueprint.
+
+          github_auth_token: GitHub authentication token for accessing private repositories.
+
+          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
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._post(
+            f"/v1/repositories/{id}/inspect",
+            body=await async_maybe_transform(
+                {
+                    "blueprint_id": blueprint_id,
+                    "github_auth_token": github_auth_token,
+                },
+                repository_inspect_params.RepositoryInspectParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=RepositoryInspectionDetails,
+        )
+
     async def list_inspections(
         self,
         id: str,
@@ -637,6 +751,9 @@ def __init__(self, repositories: RepositoriesResource) -> None:
         self.delete = to_raw_response_wrapper(
             repositories.delete,
         )
+        self.inspect = to_raw_response_wrapper(
+            repositories.inspect,
+        )
         self.list_inspections = to_raw_response_wrapper(
             repositories.list_inspections,
         )
@@ -661,6 +778,9 @@ def __init__(self, repositories: AsyncRepositoriesResource) -> None:
         self.delete = async_to_raw_response_wrapper(
             repositories.delete,
         )
+        self.inspect = async_to_raw_response_wrapper(
+            repositories.inspect,
+        )
         self.list_inspections = async_to_raw_response_wrapper(
             repositories.list_inspections,
         )
@@ -685,6 +805,9 @@ def __init__(self, repositories: RepositoriesResource) -> None:
         self.delete = to_streamed_response_wrapper(
             repositories.delete,
         )
+        self.inspect = to_streamed_response_wrapper(
+            repositories.inspect,
+        )
         self.list_inspections = to_streamed_response_wrapper(
             repositories.list_inspections,
         )
@@ -709,6 +832,9 @@ def __init__(self, repositories: AsyncRepositoriesResource) -> None:
         self.delete = async_to_streamed_response_wrapper(
             repositories.delete,
         )
+        self.inspect = async_to_streamed_response_wrapper(
+            repositories.inspect,
+        )
         self.list_inspections = async_to_streamed_response_wrapper(
             repositories.list_inspections,
         )