runloop_api_client 1.19.0__tar.gz → 1.20.1__tar.gz

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

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

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 1.20.1 (2026-05-01)
+
+Full Changelog: [v1.20.0...v1.20.1](https://github.com/runloopai/api-client-python/compare/v1.20.0...v1.20.1)
+
+### Documentation
+
+* add missing SDK operations to README-SDK ([#791](https://github.com/runloopai/api-client-python/issues/791)) ([98a746a](https://github.com/runloopai/api-client-python/commit/98a746a32075adcad2439edf751bcb2921cddfb5))
+
+## 1.20.0 (2026-04-21)
+
+Full Changelog: [v1.19.0...v1.20.0](https://github.com/runloopai/api-client-python/compare/v1.19.0...v1.20.0)
+
+### Features
+
+* add OO SDK support for new Agent API calls ([#786](https://github.com/runloopai/api-client-python/issues/786)) ([6197567](https://github.com/runloopai/api-client-python/commit/6197567bee84193beca7699b8616b46479607510))
+* **axon:** add working directory / directory to launch agent ([#8689](https://github.com/runloopai/api-client-python/issues/8689)) ([2097995](https://github.com/runloopai/api-client-python/commit/2097995f63b3e4334c6e6edb7d1c915f5447a9c9))
+
+
+### Performance Improvements
+
+* **client:** optimize file structure copying in multipart requests ([64f27ad](https://github.com/runloopai/api-client-python/commit/64f27adfc44ef5242b19637377c50073c8240538))
+
+
+### Chores
+
+* **tests:** bump steady to v0.22.1 ([c72f34d](https://github.com/runloopai/api-client-python/commit/c72f34dca3653010eb76a762a68519c996e74860))
+
 ## 1.19.0 (2026-04-13)
 
 Full Changelog: [v1.18.1...v1.19.0](https://github.com/runloopai/api-client-python/compare/v1.18.1...v1.19.0)

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.19.0
+Version: 1.20.1
 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
@@ -25,7 +25,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Requires-Dist: anyio<5,>=3.5.0
 Requires-Dist: distro<2,>=1.7.0
-Requires-Dist: httpx<1,>=0.23.0
+Requires-Dist: httpx[http2]<1,>=0.23.0
 Requires-Dist: pydantic<3,>=2.0
 Requires-Dist: sniffio
 Requires-Dist: typing-extensions<5,>=4.14

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/README-SDK.md

@@ -120,7 +120,14 @@ The SDK provides object-oriented interfaces for all major Runloop resources:
 - **`runloop.blueprint`** - Blueprint management (create, list, build blueprints)
 - **`runloop.snapshot`** - Snapshot management (list disk snapshots)
 - **`runloop.storage_object`** - Storage object management (upload, download, list objects)
+- **`runloop.agent`** - Agent management (create, list agents from npm/pip/git)
 - **`runloop.axon`** - [Beta] Axon management (create, publish events, subscribe to SSE streams, SQL queries)
+- **`runloop.scenario`** - Scenario management (list scenarios, start runs)
+- **`runloop.scorer`** - Scorer management (create, list, update)
+- **`runloop.benchmark`** - Benchmark management (create, list, run benchmarks)
+- **`runloop.network_policy`** - Network policy management (create, list, update egress rules)
+- **`runloop.gateway_config`** - Gateway config management (create, list API proxy configurations)
+- **`runloop.mcp_config`** - MCP config management (create, list MCP server configurations)
 - **`runloop.secret`** - Secret management (create, update, list, delete encrypted key-value pairs)
 - **`runloop.api`** - Direct access to the underlying REST API client
 

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "1.19.0"
+version = "1.20.1"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"
@@ -9,7 +9,7 @@ authors = [
 ]
 
 dependencies = [
-  "httpx>=0.23.0, <1",
+  "httpx[http2]>=0.23.0, <1",
   "pydantic>=2.0, <3",
   "typing-extensions>=4.14, <5",
   "anyio>=3.5.0, <5",

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/_base_client.py

@@ -1375,6 +1375,7 @@ class _DefaultAsyncHttpxClient(httpx.AsyncClient):
         kwargs.setdefault("timeout", DEFAULT_TIMEOUT)
         kwargs.setdefault("limits", DEFAULT_CONNECTION_LIMITS)
         kwargs.setdefault("follow_redirects", True)
+        kwargs.setdefault("http2", True)
         super().__init__(**kwargs)
 
 

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/_files.py

@@ -3,8 +3,8 @@ from __future__ import annotations
 import io
 import os
 import pathlib
-from typing import overload
-from typing_extensions import TypeGuard
+from typing import Sequence, cast, overload
+from typing_extensions import TypeVar, TypeGuard
 
 import anyio
 
@@ -17,7 +17,9 @@ from ._types import (
     HttpxFileContent,
     HttpxRequestFiles,
 )
-from ._utils import is_tuple_t, is_mapping_t, is_sequence_t
+from ._utils import is_list, is_mapping, is_tuple_t, is_mapping_t, is_sequence_t
+
+_T = TypeVar("_T")
 
 
 def is_base64_file_input(obj: object) -> TypeGuard[Base64FileInput]:
@@ -121,3 +123,51 @@ async def async_read_file_content(file: FileContent) -> HttpxFileContent:
         return await anyio.Path(file).read_bytes()
 
     return file
+
+
+def deepcopy_with_paths(item: _T, paths: Sequence[Sequence[str]]) -> _T:
+    """Copy only the containers along the given paths.
+
+    Used to guard against mutation by extract_files without copying the entire structure.
+    Only dicts and lists that lie on a path are copied; everything else
+    is returned by reference.
+
+    For example, given paths=[["foo", "files", "file"]] and the structure:
+        {
+            "foo": {
+                "bar": {"baz": {}},
+                "files": {"file": <content>}
+            }
+        }
+    The root dict, "foo", and "files" are copied (they lie on the path).
+    "bar" and "baz" are returned by reference (off the path).
+    """
+    return _deepcopy_with_paths(item, paths, 0)
+
+
+def _deepcopy_with_paths(item: _T, paths: Sequence[Sequence[str]], index: int) -> _T:
+    if not paths:
+        return item
+    if is_mapping(item):
+        key_to_paths: dict[str, list[Sequence[str]]] = {}
+        for path in paths:
+            if index < len(path):
+                key_to_paths.setdefault(path[index], []).append(path)
+
+        # if no path continues through this mapping, it won't be mutated and copying it is redundant
+        if not key_to_paths:
+            return item
+
+        result = dict(item)
+        for key, subpaths in key_to_paths.items():
+            if key in result:
+                result[key] = _deepcopy_with_paths(result[key], subpaths, index + 1)
+        return cast(_T, result)
+    if is_list(item):
+        array_paths = [path for path in paths if index < len(path) and path[index] == "<array>"]
+
+        # if no path expects a list here, nothing will be mutated inside it - return by reference
+        if not array_paths:
+            return cast(_T, item)
+        return cast(_T, [_deepcopy_with_paths(entry, array_paths, index + 1) for entry in item])
+    return item

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/_utils/__init__.py

@@ -25,7 +25,6 @@ from ._utils import (
     coerce_integer as coerce_integer,
     file_from_path as file_from_path,
     strip_not_given as strip_not_given,
-    deepcopy_minimal as deepcopy_minimal,
     get_async_library as get_async_library,
     maybe_coerce_float as maybe_coerce_float,
     get_required_header as get_required_header,

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/_utils/_utils.py

@@ -177,21 +177,6 @@ def is_iterable(obj: object) -> TypeGuard[Iterable[object]]:
     return isinstance(obj, Iterable)
 
 
-def deepcopy_minimal(item: _T) -> _T:
-    """Minimal reimplementation of copy.deepcopy() that will only copy certain object types:
-
-    - mappings, e.g. `dict`
-    - list
-
-    This is done for performance reasons.
-    """
-    if is_mapping(item):
-        return cast(_T, {k: deepcopy_minimal(v) for k, v in item.items()})
-    if is_list(item):
-        return cast(_T, [deepcopy_minimal(entry) for entry in item])
-    return item
-
-
 # copied from https://github.com/Rapptz/RoboDanny
 def human_join(seq: Sequence[str], *, delim: str = ", ", final: str = "or") -> str:
     size = len(seq)

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/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.19.0"  # x-release-please-version
+__version__ = "1.20.1"  # x-release-please-version

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/lib/polling_async.py

@@ -58,3 +58,46 @@ async def async_poll_until(
                 raise PollingTimeout(f"Exceeded timeout of {config.timeout_seconds} seconds", last_result)
 
         await asyncio.sleep(config.interval_seconds)
+
+
+async def retry_server_poll_until(
+    retriever: Callable[[float], Awaitable[T]],
+    is_terminal: Callable[[T], bool],
+    timeout_seconds: float = 30.0,
+    on_error: Optional[Callable[[Exception], T]] = None,
+) -> T:
+    """
+    Retry a server-side long-poll until a condition is met or max timeout is reached.
+
+    Args:
+        retriever: Async callable that takes the remaining timeout (seconds) and
+            returns the object to check.
+        is_terminal: Callable that returns True when polling should stop
+        timeout_seconds: Total time to wait.  Must be > 0
+        on_error: Optional error handler that can return a value to continue polling
+                 or re-raise the exception to stop polling
+
+    Returns:
+        The final state of the polled object
+
+    Raises:
+        PollingTimeout: When max attempts or timeout is reached
+    """
+    last_result: Union[T, None] = None
+    start_time = time.time()
+
+    while True:
+        remaining_time = timeout_seconds - (time.time() - start_time)
+        if remaining_time <= 0:
+            raise PollingTimeout(f"Exceeded timeout of {timeout_seconds} seconds", last_result)
+
+        try:
+            last_result = await retriever(remaining_time)
+        except Exception as e:
+            if on_error is not None:
+                last_result = on_error(e)
+            else:
+                raise
+
+        if is_terminal(last_result):
+            return last_result

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -37,8 +37,9 @@ from ...types import (
     devbox_snapshot_disk_async_params,
     devbox_write_file_contents_params,
 )
+from ..._files import deepcopy_with_paths
 from ..._types import Body, Omit, Query, Headers, NotGiven, FileTypes, omit, not_given
-from ..._utils import is_given, extract_files, path_template, maybe_transform, deepcopy_minimal, async_maybe_transform
+from ..._utils import is_given, extract_files, path_template, maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from .executions import (
     ExecutionsResource,
@@ -81,7 +82,7 @@ from .disk_snapshots import (
     DiskSnapshotsResourceWithStreamingResponse,
     AsyncDiskSnapshotsResourceWithStreamingResponse,
 )
-from ...lib.polling_async import async_poll_until
+from ...lib.polling_async import async_poll_until, retry_server_poll_until
 from ...types.devbox_view import DevboxView
 from ...types.tunnel_view import TunnelView
 from ...types.shared_params.mount import Mount
@@ -1607,11 +1608,12 @@ class DevboxesResource(SyncAPIResource):
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         if not is_given(timeout) and self._client.timeout == DEFAULT_TIMEOUT:
             timeout = 600
-        body = deepcopy_minimal(
+        body = deepcopy_with_paths(
             {
                 "path": path,
                 "file": file,
-            }
+            },
+            [["file"]],
         )
         files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
         # It should be noted that the actual Content-Type header that will be
@@ -2040,11 +2042,10 @@ class AsyncDevboxesResource(AsyncAPIResource):
 
         Args:
             id: The ID of the devbox to wait for
-            config: Optional polling configuration
+            polling_config: Optional polling configuration
             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
 
         Returns:
             The devbox in running state
@@ -2054,13 +2055,13 @@ class AsyncDevboxesResource(AsyncAPIResource):
             RunloopError: If devbox enters a non-running terminal state
         """
 
-        async def wait_for_devbox_status() -> DevboxView:
+        async def wait_for_devbox_status(remaining_timeout_seconds: float) -> DevboxView:
             # This wait_for_status endpoint polls the devbox status for 10 seconds until it reaches either running or failure.
             # If it's neither, it will throw an error.
             try:
                 return await self._post(
                     f"/v1/devboxes/{id}/wait_for_status",
-                    body={"statuses": ["running", "failure", "shutdown"]},
+                    body={"statuses": ["running", "failure", "shutdown"], "timeout_seconds": remaining_timeout_seconds},
                     cast_to=DevboxView,
                 )
             except (APITimeoutError, APIStatusError) as error:
@@ -2075,7 +2076,19 @@ class AsyncDevboxesResource(AsyncAPIResource):
         def is_done_booting(devbox: DevboxView) -> bool:
             return devbox.status not in DEVBOX_BOOTING_STATES
 
-        devbox = await async_poll_until(wait_for_devbox_status, is_done_booting, polling_config)
+        # calculate the timeout to use.  The PollingConfig doesn't
+        # match the semantics for server-side polling well, so we
+        # instead convert interval*attempts to a total time, and take
+        # the minimum total.
+        config = polling_config
+        if not config:
+            config = PollingConfig()  # use defaults
+
+        timeout = config.interval_seconds * config.max_attempts
+        if config.timeout_seconds is not None and config.timeout_seconds > 0:
+            timeout = min(config.timeout_seconds, timeout)
+
+        devbox = await retry_server_poll_until(wait_for_devbox_status, is_done_booting, timeout)
 
         if devbox.status != "running":
             raise RunloopError(f"Devbox entered non-running terminal state: {devbox.status}")
@@ -3241,11 +3254,12 @@ class AsyncDevboxesResource(AsyncAPIResource):
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         if not is_given(timeout) and self._client.timeout == DEFAULT_TIMEOUT:
             timeout = 600
-        body = deepcopy_minimal(
+        body = deepcopy_with_paths(
             {
                 "path": path,
                 "file": file,
-            }
+            },
+            [["file"]],
         )
         files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
         # It should be noted that the actual Content-Type header that will be

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/sdk/_types.py

@@ -19,6 +19,7 @@ from ..types import (
     McpConfigListParams,
     ObjectDownloadParams,
     ScenarioUpdateParams,
+    AgentListPublicParams,
     BenchmarkCreateParams,
     BenchmarkUpdateParams,
     BlueprintCreateParams,
@@ -191,6 +192,10 @@ class SDKAgentListParams(AgentListParams, BaseRequestOptions):
     pass
 
 
+class SDKAgentListPublicParams(AgentListPublicParams, BaseRequestOptions):
+    pass
+
+
 class SDKAxonListParams(AxonListParams, BaseRequestOptions):
     pass
 

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/sdk/agent.py

@@ -7,6 +7,7 @@ from typing_extensions import Unpack, override
 
 from ._types import (
     BaseRequestOptions,
+    LongRequestOptions,
 )
 from .._client import Runloop
 from ..types.agent_view import AgentView
@@ -68,3 +69,18 @@ class Agent:
             self._id,
             **options,
         )
+
+    def delete(
+        self,
+        **options: Unpack[LongRequestOptions],
+    ) -> object:
+        """Delete this agent. This action is irreversible.
+
+        :param options: Optional request configuration
+        :return: API response acknowledging deletion
+        :rtype: object
+        """
+        return self._client.agents.delete(
+            self._id,
+            **options,
+        )

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/sdk/async_.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 import asyncio
-from typing import Dict, Mapping, Optional
+from typing import Dict, List, Mapping, Optional
 from pathlib import Path
 from datetime import timedelta
 from typing_extensions import Unpack
@@ -27,6 +27,7 @@ from ._types import (
     SDKBenchmarkListParams,
     SDKBlueprintListParams,
     SDKMcpConfigListParams,
+    SDKAgentListPublicParams,
     SDKBenchmarkCreateParams,
     SDKBlueprintCreateParams,
     SDKMcpConfigCreateParams,
@@ -57,6 +58,7 @@ from .async_network_policy import AsyncNetworkPolicy
 from .async_storage_object import AsyncStorageObject
 from .async_scenario_builder import AsyncScenarioBuilder
 from ..types.object_create_params import ContentType
+from ..types.agent_devbox_counts_view import AgentDevboxCountsView
 from ..types.shared_params.agent_source import Git, Npm, Pip, Object
 
 
@@ -805,6 +807,35 @@ class AsyncAgentOps:
         )
         return [AsyncAgent(self._client, item.id, item) for item in page.agents]
 
+    async def list_public(
+        self,
+        **params: Unpack[SDKAgentListPublicParams],
+    ) -> List[AsyncAgent]:
+        """List public agents.
+
+        :param params: See :typeddict:`~runloop_api_client.sdk._types.SDKAgentListPublicParams` for available parameters
+        :return: Collection of public agent wrappers
+        :rtype: list[AsyncAgent]
+        """
+        page = await self._client.agents.list_public(
+            **params,
+        )
+        return [AsyncAgent(self._client, item.id, item) for item in page.agents]
+
+    async def devbox_counts(
+        self,
+        **options: Unpack[BaseRequestOptions],
+    ) -> AgentDevboxCountsView:
+        """Get devbox counts grouped by agent name.
+
+        :param options: Optional request configuration
+        :return: Devbox counts per agent name and total
+        :rtype: AgentDevboxCountsView
+        """
+        return await self._client.agents.devbox_counts(
+            **options,
+        )
+
 
 class AsyncScenarioOps:
     """Manage scenarios (async). Access via ``runloop.scenario``.

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/sdk/async_agent.py

@@ -7,6 +7,7 @@ from typing_extensions import Unpack, override
 
 from ._types import (
     BaseRequestOptions,
+    LongRequestOptions,
 )
 from .._client import AsyncRunloop
 from ..types.agent_view import AgentView
@@ -68,3 +69,18 @@ class AsyncAgent:
             self._id,
             **options,
         )
+
+    async def delete(
+        self,
+        **options: Unpack[LongRequestOptions],
+    ) -> object:
+        """Delete this agent. This action is irreversible.
+
+        :param options: Optional request configuration
+        :return: API response acknowledging deletion
+        :rtype: object
+        """
+        return await self._client.agents.delete(
+            self._id,
+            **options,
+        )

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/sdk/sync.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, Mapping, Optional
+from typing import Dict, List, Mapping, Optional
 from pathlib import Path
 from datetime import timedelta
 from typing_extensions import Unpack
@@ -28,6 +28,7 @@ from ._types import (
     SDKBenchmarkListParams,
     SDKBlueprintListParams,
     SDKMcpConfigListParams,
+    SDKAgentListPublicParams,
     SDKBenchmarkCreateParams,
     SDKBlueprintCreateParams,
     SDKMcpConfigCreateParams,
@@ -56,6 +57,7 @@ from .scenario_builder import ScenarioBuilder
 from ..types.secret_view import SecretView
 from ..lib.context_loader import TarFilter, build_directory_tar
 from ..types.object_create_params import ContentType
+from ..types.agent_devbox_counts_view import AgentDevboxCountsView
 from ..types.shared_params.agent_source import Git, Npm, Pip, Object
 
 
@@ -830,6 +832,35 @@ class AgentOps:
         )
         return [Agent(self._client, item.id, item) for item in page.agents]
 
+    def list_public(
+        self,
+        **params: Unpack[SDKAgentListPublicParams],
+    ) -> List[Agent]:
+        """List public agents.
+
+        :param params: See :typeddict:`~runloop_api_client.sdk._types.SDKAgentListPublicParams` for available parameters
+        :return: Collection of public agent wrappers
+        :rtype: list[Agent]
+        """
+        page = self._client.agents.list_public(
+            **params,
+        )
+        return [Agent(self._client, item.id, item) for item in page.agents]
+
+    def devbox_counts(
+        self,
+        **options: Unpack[BaseRequestOptions],
+    ) -> AgentDevboxCountsView:
+        """Get devbox counts grouped by agent name.
+
+        :param options: Optional request configuration
+        :return: Devbox counts per agent name and total
+        :rtype: AgentDevboxCountsView
+        """
+        return self._client.agents.devbox_counts(
+            **options,
+        )
+
 
 class ScenarioOps:
     """Manage scenarios. Access via ``runloop.scenario``.

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/types/shared/broker_mount.py

@@ -28,3 +28,9 @@ class BrokerMount(BaseModel):
 
     protocol: Optional[Literal["acp", "claude_json"]] = None
     """The protocol used by the broker to deliver events to the agent."""
+
+    working_directory: Optional[str] = None
+    """Working directory in which to launch the agent binary.
+
+    Defaults to the home directory if not specified.
+    """

{runloop_api_client-1.19.0 → runloop_api_client-1.20.1}/src/runloop_api_client/types/shared_params/broker_mount.py

@@ -30,3 +30,9 @@ class BrokerMount(TypedDict, total=False):
 
     protocol: Optional[Literal["acp", "claude_json"]]
     """The protocol used by the broker to deliver events to the agent."""
+
+    working_directory: Optional[str]
+    """Working directory in which to launch the agent binary.
+
+    Defaults to the home directory if not specified.
+    """