feat(api): api update

stainless-app[bot] · stainless-app[bot] · commit 59b9486f94c1 · 2025-10-01T21:25:01.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 91
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-034d0b86510db8b712b55ac88c1c4a322db2ce84edc632f6d27be1eb4f34fd37.yml
-openapi_spec_hash: 0485ec0d01253b2c1bdab3015370808e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-f1d928f705d6771a22fe701dfb8c0c66aabbd0dd6d17e3fa09b8eb3a48259a84.yml
+openapi_spec_hash: 12dc18a4da3f084fee3d2c5f428e1df3
 config_hash: 35e129f39a0c1fd38209b0dafb7c7562
diff --git a/src/runloop_api_client/resources/blueprints.py b/src/runloop_api_client/resources/blueprints.py
@@ -29,7 +29,6 @@
 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
@@ -72,11 +71,16 @@ 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.
@@ -86,23 +90,40 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> BlueprintView:
-        """
-        Starts build of custom defined container Blueprint using a RepositoryConnection
-        Inspection as a source container specification.
+        """Starts build of custom defined container Blueprint.
 
-        Args:
-          inspection_source: (Optional) Use a RepositoryInspection a source of a Blueprint build. The
-              Dockerfile will be automatically created based on the RepositoryInspection
-              contents.
+        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.
 
+        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.
+
+          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.
+
           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
@@ -119,11 +140,16 @@ 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,
@@ -570,11 +596,16 @@ 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.
@@ -584,23 +615,40 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> BlueprintView:
-        """
-        Starts build of custom defined container Blueprint using a RepositoryConnection
-        Inspection as a source container specification.
+        """Starts build of custom defined container Blueprint.
 
-        Args:
-          inspection_source: (Optional) Use a RepositoryInspection a source of a Blueprint build. The
-              Dockerfile will be automatically created based on the RepositoryInspection
-              contents.
+        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.
 
+        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.
+
+          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.
+
           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
@@ -617,11 +665,16 @@ 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,
diff --git a/src/runloop_api_client/types/__init__.py b/src/runloop_api_client/types/__init__.py
@@ -52,7 +52,6 @@
 from .benchmark_run_list_view import BenchmarkRunListView as BenchmarkRunListView
 from .benchmark_update_params import BenchmarkUpdateParams as BenchmarkUpdateParams
 from .blueprint_create_params import BlueprintCreateParams as BlueprintCreateParams
-from .inspection_source_param import InspectionSourceParam as InspectionSourceParam
 from .blueprint_preview_params import BlueprintPreviewParams as BlueprintPreviewParams
 from .object_download_url_view import ObjectDownloadURLView as ObjectDownloadURLView
 from .repository_create_params import RepositoryCreateParams as RepositoryCreateParams
diff --git a/src/runloop_api_client/types/blueprint_create_params.py b/src/runloop_api_client/types/blueprint_create_params.py
@@ -2,26 +2,42 @@
 
 from __future__ import annotations
 
-from typing import Dict, Optional
+from typing import Dict, Iterable, Optional
 from typing_extensions import Required, TypedDict
 
 from .._types import SequenceNotStr
-from .inspection_source_param import InspectionSourceParam
 from .shared_params.launch_parameters import LaunchParameters
+from .shared_params.code_mount_parameters import CodeMountParameters
 
-__all__ = ["BlueprintCreateParams"]
+__all__ = ["BlueprintCreateParams", "Service", "ServiceCredentials"]
 
 
 class BlueprintCreateParams(TypedDict, total=False):
-    inspection_source: Required[InspectionSourceParam]
-    """(Optional) Use a RepositoryInspection a source of a Blueprint build.
+    name: Required[str]
+    """Name of the Blueprint."""
 
-    The Dockerfile will be automatically created based on the RepositoryInspection
-    contents.
+    base_blueprint_id: Optional[str]
+    """
+    (Optional) ID of previously built blueprint to use as a base blueprint for this
+    build.
     """
 
-    name: Required[str]
-    """Name of the Blueprint."""
+    base_blueprint_name: Optional[str]
+    """
+    (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.
+    """
+
+    build_args: Optional[Dict[str, str]]
+    """(Optional) Arbitrary Docker build args to pass during build."""
+
+    code_mounts: Optional[Iterable[CodeMountParameters]]
+    """A list of code mounts to be included in the Blueprint."""
+
+    dockerfile: Optional[str]
+    """Dockerfile contents to be used to build the Blueprint."""
 
     file_mounts: Optional[Dict[str, str]]
     """(Optional) Map of paths and file contents to write before setup."""
@@ -32,5 +48,43 @@ class BlueprintCreateParams(TypedDict, total=False):
     metadata: Optional[Dict[str, str]]
     """(Optional) User defined metadata for the Blueprint."""
 
+    services: Optional[Iterable[Service]]
+    """(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: Optional[SequenceNotStr[str]]
     """A list of commands to run to set up your system."""
+
+
+class ServiceCredentials(TypedDict, total=False):
+    password: Required[str]
+    """The password of the container service."""
+
+    username: Required[str]
+    """The username of the container service."""
+
+
+class Service(TypedDict, total=False):
+    image: Required[str]
+    """The image of the container service."""
+
+    name: Required[str]
+    """The name of the container service."""
+
+    credentials: Optional[ServiceCredentials]
+    """The credentials of the container service."""
+
+    env: Optional[Dict[str, str]]
+    """The environment variables of the container service."""
+
+    options: Optional[str]
+    """Additional Docker container create options."""
+
+    port_mappings: Optional[SequenceNotStr[str]]
+    """The port mappings of the container service.
+
+    Port mappings are in the format of <host_port>:<container_port>.
+    """
diff --git a/src/runloop_api_client/types/inspection_source_param.py b/src/runloop_api_client/types/inspection_source_param.py
diff --git a/tests/api_resources/test_blueprints.py b/tests/api_resources/test_blueprints.py
