runloop_api_client 1.0.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.0.0 → runloop_api_client-1.2.0}/CHANGELOG.md

@@ -1,5 +1,45 @@
 # 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)
+
+### Features
+
+* **scenarios:** added scenario class to sdk ([#701](https://github.com/runloopai/api-client-python/issues/701)) ([121f0fc](https://github.com/runloopai/api-client-python/commit/121f0fc6efa779979f664a75e91d60c068358e21))
+* **SDK:** Build context helpers for the python clients and SDKs ([#684](https://github.com/runloopai/api-client-python/issues/684)) ([42849d6](https://github.com/runloopai/api-client-python/commit/42849d6834098d00234e5ab345ed0d91bac00435))
+
+
+### Chores
+
+* **smoketests:** fixed smoketests and cleaned up typing/formatting ([#699](https://github.com/runloopai/api-client-python/issues/699)) ([f57aae7](https://github.com/runloopai/api-client-python/commit/f57aae71be8eb801214c012b2ec66b9414f0365e))
+
 ## 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)

{runloop_api_client-1.0.0 → runloop_api_client-1.2.0}/CONTRIBUTING.md

@@ -89,13 +89,49 @@ Most tests require you to [set up a mock server](https://github.com/stoplightio/
 
 ```sh
 # you will need npm installed
-$ npx prism mock path/to/your/openapi.yml
+npx prism mock path/to/your/openapi.yml
 ```
 
 ```sh
-$ ./scripts/test
+# run all tests
+./scripts/test
+
+# pass in pytest args, eg to show info on skipped tests:
+./scripts/test -rs
+
+# Run tests for only one python version
+UV_PYTHON=3.13 ./scripts/test
+```
+
+### Running pytets
+
+Assuming you have a uv virtual env set up in .venv, the following are helpful for more granular test running:
+
+```sh
+# Run all tests pytests
+.venv/bin/pytest tests/
+
+# Run all SDK tests with verbose info
+.venv/bin/pytest tests/sdk/ -v
+
+# Run specific test class
+.venv/bin/pytest tests/sdk/test_clients.py::TestAgentClient -v
+
+# Run specific test method
+.venv/bin/pytest tests/sdk/test_clients.py::TestAgentClient::test_create_from_npm -v
+
+# Run agent smoketests (requires RUNLOOP_API_KEY)
+export RUNLOOP_API_KEY=your_key_here
+.venv/bin/pytest tests/smoketests/sdk/test_agent.py -v
+
+# Run tests matching a pattern
+.venv/bin/pytest tests/sdk/ -k "agent" -v
+
+# Run with coverage
+.venv/bin/pytest tests/sdk/ --cov=src/runloop_api_client/sdk --cov-report=html
 ```
 
+
 ## Linting and formatting
 
 This repository uses [ruff](https://github.com/astral-sh/ruff) and

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.0.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.0.0 → runloop_api_client-1.2.0}/README-SDK.md

@@ -8,11 +8,23 @@ The `RunloopSDK` builds on top of the underlying REST client and provides a Pyth
 - [Quickstart (synchronous)](#quickstart-synchronous)
 - [Quickstart (asynchronous)](#quickstart-asynchronous)
 - [Core Concepts](#core-concepts)
-- [Devbox](#devbox)
-- [Blueprint](#blueprint)
-- [Snapshot](#snapshot)
-- [StorageObject](#storageobject)
-- [Mounting Storage Objects to Devboxes](#mounting-storage-objects-to-devboxes)
+  - [RunloopSDK](#runloopsdk)
+  - [Available Resources](#available-resources)
+  - [Devbox](#devbox)
+    - [Command Execution](#command-execution)
+    - [Execution Management](#execution-management)
+    - [Execution Results](#execution-results)
+    - [Streaming Command Output](#streaming-command-output)
+    - [File Operations](#file-operations)
+    - [Network Operations](#network-operations)
+    - [Snapshot Operations](#snapshot-operations)
+    - [Devbox Lifecycle Management](#devbox-lifecycle-management)
+    - [Context Manager Support](#context-manager-support)
+  - [Blueprint](#blueprint)
+  - [Snapshot](#snapshot)
+  - [StorageObject](#storageobject)
+    - [Storage Object Upload Helpers](#storage-object-upload-helpers)
+  - [Mounting Storage Objects to Devboxes](#mounting-storage-objects-to-devboxes)
 - [Accessing the Underlying REST Client](#accessing-the-underlying-rest-client)
 - [Error Handling](#error-handling)
 - [Advanced Configuration](#advanced-configuration)
@@ -65,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:
@@ -76,6 +89,7 @@ async def main():
 
         await devbox.cmd.exec("ls", stdout=capture)
 
+
 asyncio.run(main())
 ```
 
@@ -182,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()
@@ -217,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()
@@ -249,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,
@@ -266,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,
@@ -287,6 +303,7 @@ print(content)
 
 # Upload files
 from pathlib import Path
+
 devbox.file.upload(
     path="/home/user/upload.txt",
     file=Path("local_file.txt"),
@@ -409,6 +426,36 @@ blueprint = runloop.blueprint.create(
     system_setup_commands=["pip install numpy pandas"],
 )
 
+# Or create a blueprint with a Docker build context from a local directory
+from pathlib import Path
+from runloop_api_client.lib.context_loader import build_docker_context_tar
+
+context_root = Path("./my-app")
+tar_bytes = build_docker_context_tar(context_root)
+
+build_ctx_obj = runloop.storage_object.upload_from_bytes(
+    data=tar_bytes,
+    name="my-app-context.tar.gz",
+    content_type="tgz",
+)
+
+blueprint_with_context = runloop.blueprint.create(
+    name="my-blueprint-with-context",
+    dockerfile="""\
+FROM node:22
+WORKDIR /usr/src/app
+
+# copy using the build context from the object
+COPY package.json package.json
+COPY src src
+
+RUN npm install --only=production
+CMD ["node", "src/app.js"]
+""",
+    # Build context
+    build_context=build_ctx_obj.as_build_context(),
+)
+
 # Or get an existing one
 blueprint = runloop.blueprint.from_id(blueprint_id="bpt_123")
 
@@ -493,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",
@@ -542,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()
 ```
 
@@ -689,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())
 ```
 
@@ -726,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
     ),
 )
 
@@ -734,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.0.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.0.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.0.0 → runloop_api_client-1.2.0}/pyproject.toml

@@ -1,19 +1,20 @@
 [project]
 name = "runloop_api_client"
-version = "1.0.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.0.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.0.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.0.0"  # x-release-please-version
+__version__ = "1.2.0"  # x-release-please-version

runloop_api_client-1.2.0/src/runloop_api_client/lib/__init__.py

@@ -0,0 +1,3 @@
+"""
+Helpers for `runloop_api_client`.
+"""