runloop_api_client 0.68.0__tar.gz → 1.0.0__tar.gz

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/.gitignore

@@ -23,4 +23,7 @@ htmlcov/
 coverage.json
 coverage-summary.json
 *.cover
-.pytest_cache/
+.pytest_cache/
+
+# Docs
+site/

runloop_api_client-1.0.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.0.0"
+}

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## 1.0.0 (2025-12-02)
+
+Full Changelog: [v0.69.0...v1.0.0](https://github.com/runloopai/api-client-python/compare/v0.69.0...v1.0.0)
+
+### ⚠ BREAKING CHANGES
+
+* **devbox:** made command positional arg in exec and exec_async ([#695](https://github.com/runloopai/api-client-python/issues/695))
+
+### Features
+
+* **blueprints:** Add build context to the OpenAPI spec ([#6494](https://github.com/runloopai/api-client-python/issues/6494)) ([d202b94](https://github.com/runloopai/api-client-python/commit/d202b942c07614ca954a8bbe3a9a6302e9a04216))
+* **devbox:** added devbox.shell(shellName) command and stateful shell class to SDK ([#696](https://github.com/runloopai/api-client-python/issues/696)) ([c1e8f09](https://github.com/runloopai/api-client-python/commit/c1e8f0965a419ff53d830ba3c43a1c9a29dae5c7))
+* **devbox:** made command positional arg in exec and exec_async ([#695](https://github.com/runloopai/api-client-python/issues/695)) ([6cc8c2f](https://github.com/runloopai/api-client-python/commit/6cc8c2fd4f904e8cc4386d81558157ca6fb69bfa))
+* **sdk:** added scorer classes to sdk ([#698](https://github.com/runloopai/api-client-python/issues/698)) ([85f798f](https://github.com/runloopai/api-client-python/commit/85f798f2d8a7727b783e01a260ff0a52bdf01d78))
+
+
+### Bug Fixes
+
+* **api:** don't ignore devbox keep_alive, suspend and resume in api ([fe3589f](https://github.com/runloopai/api-client-python/commit/fe3589f5fbb36a5b79f1d4a25e86f88676556fdb))
+* **devbox:** launch parameter typo ([1c9c346](https://github.com/runloopai/api-client-python/commit/1c9c346e475b64fc389928fee0f7140e532c4f9c))
+* **scenarios:** update parameters for manually maintained start_run_and_await_env_ready methods ([#692](https://github.com/runloopai/api-client-python/issues/692)) ([8000495](https://github.com/runloopai/api-client-python/commit/8000495f70b2e6f4f12742fb8a6d641dbbc088ca))
+* **scorer:** fixed RL_TEST_CONTEXT to RL_SCORER_CONTEXT ([df43a42](https://github.com/runloopai/api-client-python/commit/df43a42a45b9ce67aba27835a41c9a0ebfc6a407))
+
+
+### Chores
+
+* **blueprints:** Add build context examples ([#694](https://github.com/runloopai/api-client-python/issues/694)) ([6e63928](https://github.com/runloopai/api-client-python/commit/6e6392864b3cde20dfea5d173fed9a156b960ccd))
+* hide build context APIs ([159a38f](https://github.com/runloopai/api-client-python/commit/159a38f0980c00430a1b949541076b0d63df2df2))
+* **mounts:** Update documentation for deprecated fields to direct the user to the replacement API ([4936844](https://github.com/runloopai/api-client-python/commit/4936844989ec7a0d37c835dd37b8007e8caba944))
+
+## 0.69.0 (2025-11-21)
+
+Full Changelog: [v0.68.0...v0.69.0](https://github.com/runloopai/api-client-python/compare/v0.68.0...v0.69.0)
+
+### Features
+
+* **blueprints:** blueprints create_and_await_build_complete now take in build_context and named_build_context arguments ([#681](https://github.com/runloopai/api-client-python/issues/681)) ([1febe28](https://github.com/runloopai/api-client-python/commit/1febe28e2cadb23eae0cc411922646ce7b8875d3))
+* **devbox:** unify api for devbox mounts ([01c7d14](https://github.com/runloopai/api-client-python/commit/01c7d14091961822d7fe706d6fa7528b6607f87a))
+* **docs:** add documentation for the object oriented sdk, rendered with sphinx ([#677](https://github.com/runloopai/api-client-python/issues/677)) ([e8d1053](https://github.com/runloopai/api-client-python/commit/e8d1053edd15c07f8e8099e9736f97e5fd72fcfb))
+* **storage-objects:** Add upload_from_dir helper method ([#680](https://github.com/runloopai/api-client-python/issues/680)) ([be5d99e](https://github.com/runloopai/api-client-python/commit/be5d99ef9983a64658c38ae5e0364122d11b86c4))
+
+
+### Documentation
+
+* restructured sync vs async sdk and resources, added support for more type references ([#679](https://github.com/runloopai/api-client-python/issues/679)) ([6af891e](https://github.com/runloopai/api-client-python/commit/6af891e0b87d038b5b61a683fdf410df94f495b6))
+
 ## 0.68.0 (2025-11-19)
 
 Full Changelog: [v0.67.0...v0.68.0](https://github.com/runloopai/api-client-python/compare/v0.67.0...v0.68.0)

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 0.68.0
+Version: 1.0.0
 Summary: The official Python library for the runloop API
 Project-URL: Homepage, https://github.com/runloopai/api-client-python
 Project-URL: Repository, https://github.com/runloopai/api-client-python

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/README-SDK.md

@@ -38,12 +38,12 @@ runloop = RunloopSDK()
 
 # Create a ready-to-use devbox
 with runloop.devbox.create(name="my-devbox") as devbox:
-    result = devbox.cmd.exec(command="echo 'Hello from Runloop!'")
+    result = devbox.cmd.exec("echo 'Hello from Runloop!'")
     print(result.stdout())
 
     # Stream stdout in real time
     devbox.cmd.exec(
-        command="ls -la",
+        "ls -la",
         stdout=lambda line: print("stdout:", line),
     )
 
@@ -68,13 +68,13 @@ from runloop_api_client import AsyncRunloopSDK
 async def main():
     runloop = AsyncRunloopSDK()
     async with await runloop.devbox.create(name="async-devbox") as devbox:
-        result = await devbox.cmd.exec(command="pwd")
+        result = await devbox.cmd.exec("pwd")
         print(await result.stdout())
 
         def capture(line: str) -> None:
             print(">>", line)
 
-        await devbox.cmd.exec(command="ls", stdout=capture)
+        await devbox.cmd.exec("ls", stdout=capture)
 
 asyncio.run(main())
 ```
@@ -147,13 +147,13 @@ Execute commands synchronously or asynchronously:
 
 ```python
 # Synchronous command execution (waits for completion)
-result = devbox.cmd.exec(command="ls -la")
+result = devbox.cmd.exec("ls -la")
 print("Output:", result.stdout())
 print("Exit code:", result.exit_code)
 print("Success:", result.success)
 
 # Asynchronous command execution (returns immediately)
-execution = devbox.cmd.exec_async(command="npm run dev")
+execution = devbox.cmd.exec_async("npm run dev")
 
 # Check execution status
 state = execution.get_state()
@@ -173,7 +173,7 @@ The `Execution` object provides fine-grained control over asynchronous command e
 
 ```python
 # Start a long-running process
-execution = devbox.cmd.exec_async(command="python train_model.py")
+execution = devbox.cmd.exec_async("python train_model.py")
 
 # Get the execution ID
 print("Execution ID:", execution.execution_id)
@@ -208,10 +208,10 @@ The `ExecutionResult` object contains the output and exit status of a completed
 
 ```python
 # From synchronous execution
-result = devbox.cmd.exec(command="ls -la /tmp")
+result = devbox.cmd.exec("ls -la /tmp")
 
 # Or from asynchronous execution
-execution = devbox.cmd.exec_async(command="echo 'test'")
+execution = devbox.cmd.exec_async("echo 'test'")
 result = execution.result()
 
 # Access execution results
@@ -250,7 +250,7 @@ def handle_output(line: str) -> None:
     print("LOG:", line)
 
 result = devbox.cmd.exec(
-    command="python train.py",
+    "python train.py",
     stdout=handle_output,
     stderr=lambda line: print("ERR:", line),
     output=lambda line: print("ANY:", line),
@@ -267,7 +267,7 @@ def capture(line: str) -> None:
     log_queue.put_nowait(line)
 
 await devbox.cmd.exec(
-    command="tail -f /var/log/app.log",
+    "tail -f /var/log/app.log",
     stdout=capture,
 )
 ```
@@ -356,6 +356,8 @@ devbox.await_suspended()
 devbox.shutdown()
 ```
 
+> **State-waiting behavior:** In the synchronous SDK, `runloop.devbox.from_id()` and `devbox.resume()` block until the devbox reaches the `running` state, and `devbox.suspend()` blocks until the devbox is `suspended`. The async counterparts return immediately; call `await_running()` / `await_suspended()` explicitly if you need to wait for the state transition.
+
 #### Context Manager Support
 
 Devboxes support context managers for automatic cleanup:
@@ -363,13 +365,13 @@ Devboxes support context managers for automatic cleanup:
 ```python
 # Synchronous
 with runloop.devbox.create(name="temp-devbox") as devbox:
-    result = devbox.cmd.exec(command="echo 'Hello'")
+    result = devbox.cmd.exec("echo 'Hello'")
     print(result.stdout())
 # devbox is automatically shutdown when exiting the context
 
 # Asynchronous
 async with await runloop.devbox.create(name="temp-devbox") as devbox:
-    result = await devbox.cmd.exec(command="echo 'Hello'")
+    result = await devbox.cmd.exec("echo 'Hello'")
     print(await result.stdout())
 # devbox is automatically shutdown when exiting the context
 ```
@@ -584,7 +586,7 @@ devbox = runloop.devbox.create(
 )
 
 # The storage object is now accessible at /home/user/data.txt in the devbox
-result = devbox.cmd.exec(command="cat /home/user/data.txt")
+result = devbox.cmd.exec("cat /home/user/data.txt")
 print(result.stdout())  # "Hello, World!"
 
 # Mount archived objects (tar, tgz, gzip) - they get extracted to a directory
@@ -605,7 +607,7 @@ devbox_with_archive = runloop.devbox.create(
 )
 
 # Access extracted archive contents
-result = devbox_with_archive.cmd.exec(command="ls -la /home/user/project/")
+result = devbox_with_archive.cmd.exec("ls -la /home/user/project/")
 print(result.stdout())
 ```
 
@@ -632,7 +634,7 @@ runloop = RunloopSDK()
 
 try:
     devbox = runloop.devbox.create(name="example-devbox")
-    result = devbox.cmd.exec(command="invalid-command")
+    result = devbox.cmd.exec("invalid-command")
 except runloop_api_client.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
@@ -692,14 +694,14 @@ async def main():
     
     # All the same operations, but with await
     async with await runloop.devbox.create(name="async-devbox") as devbox:
-        result = await devbox.cmd.exec(command="pwd")
+        result = await devbox.cmd.exec("pwd")
         print(await result.stdout())
         
         # Streaming (note: callbacks must be synchronous)
         def capture(line: str) -> None:
             print(">>", line)
         
-        await devbox.cmd.exec(command="ls", stdout=capture)
+        await devbox.cmd.exec("ls", stdout=capture)
         
         # Async file operations
         await devbox.file.write(path="/tmp/test.txt", contents="Hello")

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "0.68.0"
+version = "1.0.0"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"
@@ -64,6 +64,12 @@ dev = [
     "uuid-utils>=0.11.0",
     "pytest-cov>=7.0.0",
 ]
+docs = [
+    "furo>=2025.9.25",
+    "sphinx>=7.4.7",
+    "sphinx-autodoc-typehints>=2.3.0",
+    "sphinx-toolbox>=4.0.0",
+]
 pydantic-v1 = [
     "pydantic>=1.9.0, <2",
 ]

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/src/runloop_api_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "runloop_api_client"
-__version__ = "0.68.0"  # x-release-please-version
+__version__ = "1.0.0"  # x-release-please-version

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/src/runloop_api_client/resources/blueprints.py

@@ -1,5 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-# isort: skip_file
 
 from __future__ import annotations
 
@@ -15,8 +14,7 @@ from ..types import (
     blueprint_create_from_inspection_params,
 )
 from .._types import NOT_GIVEN, Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
-from .._utils import maybe_transform, async_maybe_transform
-from .._utils._validation import ValidationNotification
+from .._utils import is_given, maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
 from .._response import (
@@ -31,6 +29,7 @@ from .._exceptions import RunloopError
 from ..lib.polling import PollingConfig, poll_until
 from .._base_client import AsyncPaginator, make_request_options
 from ..lib.polling_async import async_poll_until
+from .._utils._validation import ValidationNotification
 from ..types.blueprint_view import BlueprintView
 from ..types.blueprint_preview_view import BlueprintPreviewView
 from ..types.inspection_source_param import InspectionSourceParam
@@ -79,7 +78,7 @@ def _validate_file_mounts(file_mounts: Optional[Dict[str, str]] | Omit) -> Valid
 
     note = ValidationNotification()
 
-    if file_mounts is omit or file_mounts is None:
+    if file_mounts is None or not is_given(file_mounts):
         return note
 
     total_size_bytes = 0
@@ -137,7 +136,6 @@ class BlueprintsResource(SyncAPIResource):
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
-        named_build_contexts: Optional[Dict[str, blueprint_create_params.NamedBuildContexts]] | Omit = omit,
         secrets: Optional[Dict[str, str]] | Omit = omit,
         services: Optional[Iterable[blueprint_create_params.Service]] | Omit = omit,
         system_setup_commands: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -181,11 +179,6 @@ class BlueprintsResource(SyncAPIResource):
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
-          named_build_contexts: (Optional) Map of named build contexts to attach to the Blueprint build, where
-              the keys are the name used when referencing the contexts in a Dockerfile. See
-              Docker buildx additional contexts for details:
-              https://docs.docker.com/reference/cli/docker/buildx/build/#build-context
-
           secrets: (Optional) Map of mount IDs/environment variable names to secret names. Secrets
               will be available to commands during the build. Secrets are NOT stored in the
               blueprint image. Example: {"DB_PASS": "DATABASE_PASSWORD"} makes the secret
@@ -225,7 +218,6 @@ class BlueprintsResource(SyncAPIResource):
                     "file_mounts": file_mounts,
                     "launch_parameters": launch_parameters,
                     "metadata": metadata,
-                    "named_build_contexts": named_build_contexts,
                     "secrets": secrets,
                     "services": services,
                     "system_setup_commands": system_setup_commands,
@@ -327,11 +319,13 @@ class BlueprintsResource(SyncAPIResource):
         base_blueprint_id: Optional[str] | Omit = omit,
         base_blueprint_name: Optional[str] | Omit = omit,
         build_args: Optional[Dict[str, str]] | Omit = omit,
+        build_context: Optional[blueprint_create_params.BuildContext] | 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,
+        named_build_contexts: Optional[Dict[str, blueprint_create_params.NamedBuildContexts]] | Omit = omit,
         secrets: Optional[Dict[str, str]] | Omit = omit,
         services: Optional[Iterable[blueprint_create_params.Service]] | Omit = omit,
         system_setup_commands: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -365,11 +359,13 @@ class BlueprintsResource(SyncAPIResource):
             base_blueprint_id=base_blueprint_id,
             base_blueprint_name=base_blueprint_name,
             build_args=build_args,
+            build_context=build_context,
             code_mounts=code_mounts,
             dockerfile=dockerfile,
             file_mounts=file_mounts,
             launch_parameters=launch_parameters,
             metadata=metadata,
+            named_build_contexts=named_build_contexts,
             secrets=secrets,
             services=services,
             system_setup_commands=system_setup_commands,
@@ -655,7 +651,6 @@ class BlueprintsResource(SyncAPIResource):
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
-        named_build_contexts: Optional[Dict[str, blueprint_preview_params.NamedBuildContexts]] | Omit = omit,
         secrets: Optional[Dict[str, str]] | Omit = omit,
         services: Optional[Iterable[blueprint_preview_params.Service]] | Omit = omit,
         system_setup_commands: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -697,11 +692,6 @@ class BlueprintsResource(SyncAPIResource):
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
-          named_build_contexts: (Optional) Map of named build contexts to attach to the Blueprint build, where
-              the keys are the name used when referencing the contexts in a Dockerfile. See
-              Docker buildx additional contexts for details:
-              https://docs.docker.com/reference/cli/docker/buildx/build/#build-context
-
           secrets: (Optional) Map of mount IDs/environment variable names to secret names. Secrets
               will be available to commands during the build. Secrets are NOT stored in the
               blueprint image. Example: {"DB_PASS": "DATABASE_PASSWORD"} makes the secret
@@ -737,7 +727,6 @@ class BlueprintsResource(SyncAPIResource):
                     "file_mounts": file_mounts,
                     "launch_parameters": launch_parameters,
                     "metadata": metadata,
-                    "named_build_contexts": named_build_contexts,
                     "secrets": secrets,
                     "services": services,
                     "system_setup_commands": system_setup_commands,
@@ -788,7 +777,6 @@ class AsyncBlueprintsResource(AsyncAPIResource):
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
-        named_build_contexts: Optional[Dict[str, blueprint_create_params.NamedBuildContexts]] | Omit = omit,
         secrets: Optional[Dict[str, str]] | Omit = omit,
         services: Optional[Iterable[blueprint_create_params.Service]] | Omit = omit,
         system_setup_commands: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -832,11 +820,6 @@ class AsyncBlueprintsResource(AsyncAPIResource):
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
-          named_build_contexts: (Optional) Map of named build contexts to attach to the Blueprint build, where
-              the keys are the name used when referencing the contexts in a Dockerfile. See
-              Docker buildx additional contexts for details:
-              https://docs.docker.com/reference/cli/docker/buildx/build/#build-context
-
           secrets: (Optional) Map of mount IDs/environment variable names to secret names. Secrets
               will be available to commands during the build. Secrets are NOT stored in the
               blueprint image. Example: {"DB_PASS": "DATABASE_PASSWORD"} makes the secret
@@ -876,7 +859,6 @@ class AsyncBlueprintsResource(AsyncAPIResource):
                     "file_mounts": file_mounts,
                     "launch_parameters": launch_parameters,
                     "metadata": metadata,
-                    "named_build_contexts": named_build_contexts,
                     "secrets": secrets,
                     "services": services,
                     "system_setup_commands": system_setup_commands,
@@ -978,11 +960,13 @@ class AsyncBlueprintsResource(AsyncAPIResource):
         base_blueprint_id: Optional[str] | Omit = omit,
         base_blueprint_name: Optional[str] | Omit = omit,
         build_args: Optional[Dict[str, str]] | Omit = omit,
+        build_context: Optional[blueprint_create_params.BuildContext] | 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,
+        named_build_contexts: Optional[Dict[str, blueprint_create_params.NamedBuildContexts]] | Omit = omit,
         secrets: Optional[Dict[str, str]] | Omit = omit,
         services: Optional[Iterable[blueprint_create_params.Service]] | Omit = omit,
         system_setup_commands: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -1016,11 +1000,13 @@ class AsyncBlueprintsResource(AsyncAPIResource):
             base_blueprint_id=base_blueprint_id,
             base_blueprint_name=base_blueprint_name,
             build_args=build_args,
+            build_context=build_context,
             code_mounts=code_mounts,
             dockerfile=dockerfile,
             file_mounts=file_mounts,
             launch_parameters=launch_parameters,
             metadata=metadata,
+            named_build_contexts=named_build_contexts,
             secrets=secrets,
             services=services,
             system_setup_commands=system_setup_commands,
@@ -1306,7 +1292,6 @@ class AsyncBlueprintsResource(AsyncAPIResource):
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
-        named_build_contexts: Optional[Dict[str, blueprint_preview_params.NamedBuildContexts]] | Omit = omit,
         secrets: Optional[Dict[str, str]] | Omit = omit,
         services: Optional[Iterable[blueprint_preview_params.Service]] | Omit = omit,
         system_setup_commands: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -1348,11 +1333,6 @@ class AsyncBlueprintsResource(AsyncAPIResource):
 
           metadata: (Optional) User defined metadata for the Blueprint.
 
-          named_build_contexts: (Optional) Map of named build contexts to attach to the Blueprint build, where
-              the keys are the name used when referencing the contexts in a Dockerfile. See
-              Docker buildx additional contexts for details:
-              https://docs.docker.com/reference/cli/docker/buildx/build/#build-context
-
           secrets: (Optional) Map of mount IDs/environment variable names to secret names. Secrets
               will be available to commands during the build. Secrets are NOT stored in the
               blueprint image. Example: {"DB_PASS": "DATABASE_PASSWORD"} makes the secret
@@ -1388,7 +1368,6 @@ class AsyncBlueprintsResource(AsyncAPIResource):
                     "file_mounts": file_mounts,
                     "launch_parameters": launch_parameters,
                     "metadata": metadata,
-                    "named_build_contexts": named_build_contexts,
                     "secrets": secrets,
                     "services": services,
                     "system_setup_commands": system_setup_commands,

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -217,7 +217,7 @@ class DevboxesResource(SyncAPIResource):
               successfully built Blueprint with the given name. Only one of (Snapshot ID,
               Blueprint ID, Blueprint name) should be specified.
 
-          code_mounts: A list of code mounts to be included in the Devbox.
+          code_mounts: A list of code mounts to be included in the Devbox. Use mounts instead.
 
           entrypoint: (Optional) When specified, the Devbox will run this script as its main
               executable. The devbox lifecycle will be bound to entrypoint, shutting down when
@@ -225,13 +225,13 @@ class DevboxesResource(SyncAPIResource):
 
           environment_variables: (Optional) Environment variables used to configure your Devbox.
 
-          file_mounts: (Optional) Map of paths and file contents to write before setup..
+          file_mounts: Map of paths and file contents to write before setup. Use mounts instead.
 
           launch_parameters: Parameters to configure the resources and launch time behavior of the Devbox.
 
           metadata: User defined metadata to attach to the devbox for organization.
 
-          mounts: A list of file system mounts to be included in the Devbox.
+          mounts: A list of mounts to be included in the Devbox.
 
           name: (Optional) A user specified name to give the Devbox.
 
@@ -1755,7 +1755,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
               successfully built Blueprint with the given name. Only one of (Snapshot ID,
               Blueprint ID, Blueprint name) should be specified.
 
-          code_mounts: A list of code mounts to be included in the Devbox.
+          code_mounts: A list of code mounts to be included in the Devbox. Use mounts instead.
 
           entrypoint: (Optional) When specified, the Devbox will run this script as its main
               executable. The devbox lifecycle will be bound to entrypoint, shutting down when
@@ -1763,13 +1763,13 @@ class AsyncDevboxesResource(AsyncAPIResource):
 
           environment_variables: (Optional) Environment variables used to configure your Devbox.
 
-          file_mounts: (Optional) Map of paths and file contents to write before setup..
+          file_mounts: Map of paths and file contents to write before setup. Use mounts instead.
 
           launch_parameters: Parameters to configure the resources and launch time behavior of the Devbox.
 
           metadata: User defined metadata to attach to the devbox for organization.
 
-          mounts: A list of file system mounts to be included in the Devbox.
+          mounts: A list of mounts to be included in the Devbox.
 
           name: (Optional) A user specified name to give the Devbox.
 

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/src/runloop_api_client/resources/scenarios/scenarios.py

@@ -30,7 +30,7 @@ from .scorers import (
     ScorersResourceWithStreamingResponse,
     AsyncScorersResourceWithStreamingResponse,
 )
-from ..._types import NOT_GIVEN, Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
+from ..._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
@@ -457,17 +457,17 @@ class ScenariosResource(SyncAPIResource):
         self,
         *,
         scenario_id: str,
-        benchmark_run_id: Optional[str] | NotGiven = NOT_GIVEN,
-        metadata: Optional[Dict[str, str]] | NotGiven = NOT_GIVEN,
-        run_name: Optional[str] | NotGiven = NOT_GIVEN,
-        run_profile: Optional[scenario_start_run_params.RunProfile] | NotGiven = NOT_GIVEN,
+        benchmark_run_id: Optional[str] | Omit = omit,
+        metadata: Optional[Dict[str, str]] | Omit = omit,
+        run_name: Optional[str] | Omit = omit,
+        run_profile: Optional[scenario_start_run_params.RunProfile] | Omit = omit,
         polling_config: PollingConfig | None = None,
         # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> ScenarioRunView:
         """Start a new ScenarioRun and wait for its environment to be ready.
@@ -913,11 +913,18 @@ class AsyncScenariosResource(AsyncAPIResource):
     async def start_run_and_await_env_ready(
         self,
         scenario_id: str,
-        benchmark_run_id: Optional[str] | NotGiven = NOT_GIVEN,
-        metadata: Optional[Dict[str, str]] | NotGiven = NOT_GIVEN,
-        run_name: Optional[str] | NotGiven = NOT_GIVEN,
-        run_profile: Optional[scenario_start_run_params.RunProfile] | NotGiven = NOT_GIVEN,
+        benchmark_run_id: Optional[str] | Omit = omit,
+        metadata: Optional[Dict[str, str]] | Omit = omit,
+        run_name: Optional[str] | Omit = omit,
+        run_profile: Optional[scenario_start_run_params.RunProfile] | Omit = omit,
         polling_config: PollingConfig | None = None,
+        # 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,
     ) -> ScenarioRunView:
         """Start a new ScenarioRun and wait for its environment to be ready.
 
@@ -941,6 +948,11 @@ class AsyncScenariosResource(AsyncAPIResource):
             metadata=metadata,
             run_name=run_name,
             run_profile=run_profile,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+            idempotency_key=idempotency_key,
         )
 
         await self._client.devboxes.await_running(

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/src/runloop_api_client/sdk/__init__.py

@@ -5,19 +5,22 @@ Provides both sync (`RunloopSDK`) and async (`AsyncRunloopSDK`) interfaces.
 
 from __future__ import annotations
 
-from .sync import DevboxOps, RunloopSDK, SnapshotOps, BlueprintOps, StorageObjectOps
+from .sync import DevboxOps, ScorerOps, RunloopSDK, SnapshotOps, BlueprintOps, StorageObjectOps
 from .async_ import (
     AsyncDevboxOps,
+    AsyncScorerOps,
     AsyncRunloopSDK,
     AsyncSnapshotOps,
     AsyncBlueprintOps,
     AsyncStorageObjectOps,
 )
-from .devbox import Devbox
+from .devbox import Devbox, NamedShell
+from .scorer import Scorer
 from .snapshot import Snapshot
 from .blueprint import Blueprint
 from .execution import Execution
-from .async_devbox import AsyncDevbox
+from .async_devbox import AsyncDevbox, AsyncNamedShell
+from .async_scorer import AsyncScorer
 from .async_snapshot import AsyncSnapshot
 from .storage_object import StorageObject
 from .async_blueprint import AsyncBlueprint
@@ -35,6 +38,8 @@ __all__ = [
     "AsyncDevboxOps",
     "BlueprintOps",
     "AsyncBlueprintOps",
+    "ScorerOps",
+    "AsyncScorerOps",
     "SnapshotOps",
     "AsyncSnapshotOps",
     "StorageObjectOps",
@@ -48,8 +53,12 @@ __all__ = [
     "AsyncExecutionResult",
     "Blueprint",
     "AsyncBlueprint",
+    "Scorer",
+    "AsyncScorer",
     "Snapshot",
     "AsyncSnapshot",
     "StorageObject",
     "AsyncStorageObject",
+    "NamedShell",
+    "AsyncNamedShell",
 ]

{runloop_api_client-0.68.0 → runloop_api_client-1.0.0}/src/runloop_api_client/sdk/_helpers.py

@@ -39,11 +39,11 @@ T = TypeVar("T")
 def filter_params(params: Mapping[str, Any], type_filter: Type[T]) -> T:
     """Filter params dict to only include keys defined in the given TypedDict type.
 
-    Args:
-        params: Dictionary or TypedDict of parameters to filter
-        type_filter: TypedDict class to filter against
-
-    Returns:
-        Filtered dictionary matching the TypedDict structure
+    :param params: Dictionary or TypedDict of parameters to filter
+    :type params: Mapping[str, Any]
+    :param type_filter: TypedDict class to filter against
+    :type type_filter: Type[T]
+    :return: Filtered dictionary matching the TypedDict structure
+    :rtype: T
     """
     return {k: v for k, v in params.items() if k in type_filter.__annotations__}  # type: ignore[return-value]