runloop-api-client 1.1.0__tar.gz → 1.2.0__tar.gz

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

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

{runloop_api_client-1.1.0 → runloop_api_client-1.2.0}/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 1.2.0 (2025-12-09)
+
+Full Changelog: [v1.1.0...v1.2.0](https://github.com/runloopai/api-client-python/compare/v1.1.0...v1.2.0)
+
+### Features
+
+* **devbox:** default to x86 arch ([501de0b](https://github.com/runloopai/api-client-python/commit/501de0bb1d76c836ff9f448513a16155641345ae))
+* **devbox:** return user for createSshKey ([f094bf7](https://github.com/runloopai/api-client-python/commit/f094bf7443a0ca5bab6d47a53b7b14bade3cecd0))
+
+
+### Bug Fixes
+
+* ensure streams are always closed ([d01aae2](https://github.com/runloopai/api-client-python/commit/d01aae204d8c57ac76646df0e0e1078e64ad9891))
+
+
+### Chores
+
+* bump required `uv` version ([8ad519f](https://github.com/runloopai/api-client-python/commit/8ad519fd26d389628d157a413a0b0f1f5d435e9e))
+* **deps:** mypy 1.18.1 has a regression, pin to 1.17 ([e56582a](https://github.com/runloopai/api-client-python/commit/e56582a93590445d8e545b6123be0f14db39a8f5))
+* **docs:** use environment variables for authentication in code snippets ([55cf613](https://github.com/runloopai/api-client-python/commit/55cf6131edb8d38144761c5dbbbcf9389093ed7b))
+* **internal:** version bump ([2fa85c6](https://github.com/runloopai/api-client-python/commit/2fa85c6694dc468280eedb28136aadcda4f11801))
+* remove some unnecessary changes to reduce diff from Stainless ([#705](https://github.com/runloopai/api-client-python/issues/705)) ([715c9d0](https://github.com/runloopai/api-client-python/commit/715c9d09f4e874032ee1d4d6c81d80ab6a72ec45))
+* update lockfile ([7e0136d](https://github.com/runloopai/api-client-python/commit/7e0136dfcd62a2843138ae382bd6fedfd881e1b3))
+* update requirements-dev.lock ([#707](https://github.com/runloopai/api-client-python/issues/707)) ([a2d5326](https://github.com/runloopai/api-client-python/commit/a2d5326634cad5afe6c74252d26b01916ed41bcb))
+* update uv.lock ([b9e0729](https://github.com/runloopai/api-client-python/commit/b9e07291745291d16f122dbca5ef513ed134c5dd))
+
 ## 1.1.0 (2025-12-06)
 
 Full Changelog: [v1.0.0...v1.1.0](https://github.com/runloopai/api-client-python/compare/v1.0.0...v1.1.0)

{runloop_api_client-1.1.0 → runloop_api_client-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.1.0
+Version: 1.2.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
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.9
@@ -137,6 +138,7 @@ pip install runloop_api_client[aiohttp]
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
+import os
 import asyncio
 from runloop_api_client import DefaultAioHttpClient
 from runloop_api_client import AsyncRunloop
@@ -144,7 +146,7 @@ from runloop_api_client import AsyncRunloop
 
 async def main() -> None:
     async with AsyncRunloop(
-        bearer_token="My Bearer Token",
+        bearer_token=os.environ.get("RUNLOOP_API_KEY"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
         devbox_view = await client.devboxes.create()

{runloop_api_client-1.1.0 → runloop_api_client-1.2.0}/README-SDK.md

@@ -77,6 +77,7 @@ print(obj.download_as_text())
 import asyncio
 from runloop_api_client import AsyncRunloopSDK
 
+
 async def main():
     runloop = AsyncRunloopSDK()
     async with await runloop.devbox.create(name="async-devbox") as devbox:
@@ -88,6 +89,7 @@ async def main():
 
         await devbox.cmd.exec("ls", stdout=capture)
 
+
 asyncio.run(main())
 ```
 
@@ -194,7 +196,7 @@ print("Devbox ID:", execution.devbox_id)
 # Poll for current state
 state = execution.get_state()
 print("Status:", state.status)  # "running", "completed", etc.
-print("Exit code:", state.exit_status) # only set when execution has completed
+print("Exit code:", state.exit_status)  # only set when execution has completed
 
 # Wait for completion and get results
 result = execution.result()
@@ -229,7 +231,7 @@ result = execution.result()
 # Access execution results
 print("Exit code:", result.exit_code)
 print("Success:", result.success)  # True if exit code is 0
-print("Failed:", result.failed)    # True if exit code is non-zero
+print("Failed:", result.failed)  # True if exit code is non-zero
 
 # Get output streams
 stdout = result.stdout()
@@ -261,6 +263,7 @@ Pass callbacks into `cmd.exec` / `cmd.exec_async` to process logs in real time:
 def handle_output(line: str) -> None:
     print("LOG:", line)
 
+
 result = devbox.cmd.exec(
     "python train.py",
     stdout=handle_output,
@@ -278,6 +281,7 @@ def capture(line: str) -> None:
     # Use thread-safe data structures if needed
     log_queue.put_nowait(line)
 
+
 await devbox.cmd.exec(
     "tail -f /var/log/app.log",
     stdout=capture,
@@ -299,6 +303,7 @@ print(content)
 
 # Upload files
 from pathlib import Path
+
 devbox.file.upload(
     path="/home/user/upload.txt",
     file=Path("local_file.txt"),
@@ -434,15 +439,6 @@ build_ctx_obj = runloop.storage_object.upload_from_bytes(
     content_type="tgz",
 )
 
-shared_root = Path("./shared-lib")
-shared_tar = build_docker_context_tar(shared_root)
-
-shared_ctx_obj = runloop.storage_object.upload_from_bytes(
-    data=shared_tar,
-    name="shared-lib-context.tar.gz",
-    content_type="tgz",
-)
-
 blueprint_with_context = runloop.blueprint.create(
     name="my-blueprint-with-context",
     dockerfile="""\
@@ -453,18 +449,11 @@ WORKDIR /usr/src/app
 COPY package.json package.json
 COPY src src
 
-# copy from named context
-COPY --from=shared / ./libs
-
 RUN npm install --only=production
 CMD ["node", "src/app.js"]
 """,
-    # Primary build context
+    # Build context
     build_context=build_ctx_obj.as_build_context(),
-    # Additional named build contexts (for Docker buildx-style usage)
-    named_build_contexts={
-        "shared": shared_ctx_obj.as_build_context(),
-    },
 )
 
 # Or get an existing one
@@ -551,6 +540,7 @@ storage_object.complete()
 
 # Upload from file
 from pathlib import Path
+
 uploaded = runloop.storage_object.upload_from_file(
     Path("/path/to/file.txt"),
     name="my-file.txt",
@@ -600,7 +590,7 @@ obj = runloop.storage_object.create(
     name="data.bin",
     content_type="binary",
 )
-obj.upload_content(b"\xDE\xAD\xBE\xEF")
+obj.upload_content(b"\xde\xad\xbe\xef")
 obj.complete()
 ```
 
@@ -747,28 +737,30 @@ The async SDK has the same interface as the synchronous version, but all I/O ope
 import asyncio
 from runloop_api_client import AsyncRunloopSDK
 
+
 async def main():
     runloop = AsyncRunloopSDK()
-    
+
     # All the same operations, but with await
     async with await runloop.devbox.create(name="async-devbox") as devbox:
         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("ls", stdout=capture)
-        
+
         # Async file operations
         await devbox.file.write(path="/tmp/test.txt", contents="Hello")
         content = await devbox.file.read(path="/tmp/test.txt")
-        
+
         # Async network operations
         tunnel = await devbox.net.create_tunnel(port=8080)
         print("Tunnel URL:", tunnel.url)
 
+
 asyncio.run(main())
 ```
 
@@ -784,7 +776,7 @@ devbox = runloop.devbox.create(
     name="my-devbox",
     polling_config=PollingConfig(
         timeout_seconds=300.0,  # Wait up to 5 minutes
-        interval_seconds=2.0,   # Poll every 2 seconds
+        interval_seconds=2.0,  # Poll every 2 seconds
     ),
 )
 
@@ -792,7 +784,7 @@ devbox = runloop.devbox.create(
 snapshot.await_completed(
     polling_config=PollingConfig(
         timeout_seconds=600.0,  # Wait up to 10 minutes
-        interval_seconds=5.0,   # Poll every 5 seconds
+        interval_seconds=5.0,  # Poll every 5 seconds
     ),
 )
 ```

{runloop_api_client-1.1.0 → runloop_api_client-1.2.0}/README.md

@@ -102,6 +102,7 @@ pip install runloop_api_client[aiohttp]
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
+import os
 import asyncio
 from runloop_api_client import DefaultAioHttpClient
 from runloop_api_client import AsyncRunloop
@@ -109,7 +110,7 @@ from runloop_api_client import AsyncRunloop
 
 async def main() -> None:
     async with AsyncRunloop(
-        bearer_token="My Bearer Token",
+        bearer_token=os.environ.get("RUNLOOP_API_KEY"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
         devbox_view = await client.devboxes.create()

{runloop_api_client-1.1.0 → runloop_api_client-1.2.0}/api.md

@@ -3,12 +3,10 @@
 ```python
 from runloop_api_client.types import (
     AfterIdle,
-    AgentMountParameters,
     AgentSource,
     CodeMountParameters,
     LaunchParameters,
     Mount,
-    ObjectMountParameters,
     RunProfile,
 )
 ```

{runloop_api_client-1.1.0 → runloop_api_client-1.2.0}/pyproject.toml

@@ -1,19 +1,20 @@
 [project]
 name = "runloop_api_client"
-version = "1.1.0"
+version = "1.2.0"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"
 authors = [
 { name = "Runloop", email = "support@runloop.ai" },
 ]
+
 dependencies = [
-    "httpx>=0.23.0, <1",
-    "pydantic>=1.9.0, <3",
-    "typing-extensions>=4.10, <5",
-    "anyio>=3.5.0, <5",
-    "distro>=1.7.0, <2",
-    "sniffio",
+  "httpx>=0.23.0, <1",
+  "pydantic>=1.9.0, <3",
+  "typing-extensions>=4.10, <5",
+  "anyio>=3.5.0, <5",
+  "distro>=1.7.0, <2",
+  "sniffio",
     "uuid-utils>=0.11.0",
 ]
 
@@ -26,6 +27,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Operating System :: OS Independent",
   "Operating System :: POSIX",
   "Operating System :: MacOS",
@@ -44,13 +46,19 @@ aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.9"]
 
 [tool.uv]
 managed = true
-required-version = ">=0.5.0"
+required-version = ">=0.9"
+conflicts = [
+    [
+      { group = "pydantic-v1" },
+      { group = "pydantic-v2" },
+    ],
+]
 
 [dependency-groups]
 # version pins are in uv.lock
 dev = [
     "pyright==1.1.399",
-    "mypy",
+    "mypy==1.17",
     "respx",
     "pytest",
     "pytest-asyncio",
@@ -64,51 +72,24 @@ dev = [
     "uuid-utils>=0.11.0",
     "pytest-cov>=7.0.0",
 ]
+pydantic-v1 = [
+    "pydantic>=1.9.0,<2",
+]
+pydantic-v2 = [
+    "pydantic~=2.0 ; python_full_version < '3.14'",
+    "pydantic~=2.12 ; python_full_version >= '3.14'",
+]
 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",
-]
-
-[tool.rye.scripts]
-format = { chain = [
-  "format:ruff",
-  "format:docs",
-  "fix:ruff",
-  # run formatting again to fix any inconsistencies when imports are stripped
-  "format:ruff",
-]}
-"format:docs" = "python scripts/utils/ruffen-docs.py README.md api.md"
-"format:ruff" = "ruff format"
-
-"lint" = { chain = [
-  "check:ruff",
-  "typecheck",
-  "check:importable",
-]}
-"check:ruff" = "ruff check ."
-"fix:ruff" = "ruff check --fix ."
-
-"check:importable" = "python -c 'import runloop_api_client'"
-
-typecheck = { chain = [
-  "typecheck:pyright",
-  "typecheck:mypy"
-]}
-
-"typecheck:pyright" = "pyright"
-"typecheck:verify-types" = "pyright --verifytypes runloop_api_client --ignoreexternal"
-"typecheck:mypy" = "mypy ."
 
 [build-system]
 requires = ["hatchling==1.26.3", "hatch-fancy-pypi-readme"]
 build-backend = "hatchling.build"
 
-
 [tool.hatch.build]
 include = [
   "src/*"

runloop_api_client-1.2.0/requirements-dev.lock

@@ -0,0 +1,110 @@
+# This file was autogenerated by uv via the following command:
+#    uv export -o requirements-dev.lock --no-hashes
+-e .
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.12.0
+    # via
+    #   httpx
+    #   runloop-api-client
+backports-asyncio-runner==1.2.0 ; python_full_version < '3.11'
+    # via pytest-asyncio
+certifi==2025.11.12
+    # via
+    #   httpcore
+    #   httpx
+colorama==0.4.6 ; sys_platform == 'win32'
+    # via pytest
+dirty-equals==0.11
+distro==1.9.0
+    # via runloop-api-client
+exceptiongroup==1.3.1 ; python_full_version < '3.11'
+    # via
+    #   anyio
+    #   pytest
+execnet==2.1.2
+    # via pytest-xdist
+h11==0.16.0
+    # via httpcore
+httpcore==1.0.9
+    # via httpx
+httpx==0.28.1
+    # via
+    #   respx
+    #   runloop-api-client
+idna==3.11
+    # via
+    #   anyio
+    #   httpx
+importlib-metadata==8.7.0
+iniconfig==2.1.0 ; python_full_version < '3.10'
+    # via pytest
+iniconfig==2.3.0 ; python_full_version >= '3.10'
+    # via pytest
+markdown-it-py==3.0.0 ; python_full_version < '3.10'
+    # via rich
+markdown-it-py==4.0.0 ; python_full_version >= '3.10'
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+mypy==1.17.0
+mypy-extensions==1.1.0
+    # via mypy
+nodeenv==1.9.1
+    # via pyright
+packaging==25.0
+    # via pytest
+pathspec==0.12.1
+    # via mypy
+pluggy==1.6.0
+    # via pytest
+pydantic==2.12.5
+    # via runloop-api-client
+pydantic-core==2.41.5
+    # via pydantic
+pygments==2.19.2
+    # via
+    #   pytest
+    #   rich
+pyright==1.1.399
+pytest==8.4.2 ; python_full_version < '3.10'
+    # via
+    #   pytest-asyncio
+    #   pytest-xdist
+pytest==9.0.1 ; python_full_version >= '3.10'
+    # via
+    #   pytest-asyncio
+    #   pytest-xdist
+pytest-asyncio==1.2.0 ; python_full_version < '3.10'
+pytest-asyncio==1.3.0 ; python_full_version >= '3.10'
+pytest-xdist==3.8.0
+python-dateutil==2.9.0.post0 ; python_full_version < '3.10'
+    # via time-machine
+respx==0.22.0
+rich==14.2.0
+ruff==0.14.7
+six==1.17.0 ; python_full_version < '3.10'
+    # via python-dateutil
+sniffio==1.3.1
+    # via runloop-api-client
+time-machine==2.19.0 ; python_full_version < '3.10'
+time-machine==3.1.0 ; python_full_version >= '3.10'
+tomli==2.3.0 ; python_full_version < '3.11'
+    # via
+    #   mypy
+    #   pytest
+typing-extensions==4.15.0
+    # via
+    #   anyio
+    #   exceptiongroup
+    #   mypy
+    #   pydantic
+    #   pydantic-core
+    #   pyright
+    #   pytest-asyncio
+    #   runloop-api-client
+    #   typing-inspection
+typing-inspection==0.4.2
+    # via pydantic
+zipp==3.23.0
+    # via importlib-metadata

{runloop_api_client-1.1.0 → runloop_api_client-1.2.0}/src/runloop_api_client/_streaming.py

@@ -73,22 +73,22 @@ class Stream(Generic[_T]):
         process_data = self._client._process_response_data
         iterator = self._iter_events()
 
-        for sse in iterator:
-            # Surface server-sent error events as API errors to allow callers to handle/retry
-            if sse.event == "error":
-                try:
-                    error_obj = json.loads(sse.data)
-                    status_code = int(error_obj.get("code", 500))
-                    # Build a synthetic response to mirror normal error handling
-                    fake_resp = httpx.Response(status_code, request=response.request, content=sse.data)
-                except Exception:
-                    fake_resp = httpx.Response(500, request=response.request, content=sse.data)
-                raise self._client._make_status_error_from_response(fake_resp)
-
-            yield process_data(data=sse.json(), cast_to=cast_to, response=response)
-
-        # As we might not fully consume the response stream, we need to close it explicitly
-        response.close()
+        try:
+            for sse in iterator:
+                # Surface server-sent error events as API errors to allow callers to handle/retry
+                if sse.event == "error":
+                    try:
+                        error_obj = json.loads(sse.data)
+                        status_code = int(error_obj.get("code", 500))
+                        fake_resp = httpx.Response(status_code, request=response.request, content=sse.data)
+                    except Exception:
+                        fake_resp = httpx.Response(500, request=response.request, content=sse.data)
+                    raise self._client._make_status_error_from_response(fake_resp)
+
+                yield process_data(data=sse.json(), cast_to=cast_to, response=response)
+        finally:
+            # Ensure the response is closed even if the consumer doesn't read all data
+            response.close()
 
     def __enter__(self) -> Self:
         return self
@@ -147,22 +147,22 @@ class AsyncStream(Generic[_T]):
         process_data = self._client._process_response_data
         iterator = self._iter_events()
 
-        async for sse in iterator:
-            # Surface server-sent error events as API errors to allow callers to handle/retry
-            if sse.event == "error":
-                try:
-                    error_obj = json.loads(sse.data)
-                    status_code = int(error_obj.get("code", 500))
-                    # Build a synthetic response to mirror normal error handling
-                    fake_resp = httpx.Response(status_code, request=response.request, content=sse.data)
-                except Exception:
-                    fake_resp = httpx.Response(500, request=response.request, content=sse.data)
-                raise self._client._make_status_error_from_response(fake_resp)
-
-            yield process_data(data=sse.json(), cast_to=cast_to, response=response)
-
-        # As we might not fully consume the response stream, we need to close it explicitly
-        await response.aclose()
+        try:
+            async for sse in iterator:
+                # Surface server-sent error events as API errors to allow callers to handle/retry
+                if sse.event == "error":
+                    try:
+                        error_obj = json.loads(sse.data)
+                        status_code = int(error_obj.get("code", 500))
+                        fake_resp = httpx.Response(status_code, request=response.request, content=sse.data)
+                    except Exception:
+                        fake_resp = httpx.Response(500, request=response.request, content=sse.data)
+                    raise self._client._make_status_error_from_response(fake_resp)
+
+                yield process_data(data=sse.json(), cast_to=cast_to, response=response)
+        finally:
+            # Ensure the response is closed even if the consumer doesn't read all data
+            await response.aclose()
 
     async def __aenter__(self) -> Self:
         return self

{runloop_api_client-1.1.0 → runloop_api_client-1.2.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__ = "1.1.0"  # x-release-please-version
+__version__ = "1.2.0"  # x-release-please-version

{runloop_api_client-1.1.0 → runloop_api_client-1.2.0}/src/runloop_api_client/resources/blueprints.py

@@ -325,7 +325,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,
@@ -365,7 +364,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,
@@ -966,7 +964,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,
@@ -1006,7 +1003,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,