feat(devbox): add gateway routes (#7212)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 106
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-63dab7833d6670810c4f4882df560ebbfe2de8e8e1a98d51422368607b5335ae.yml
-openapi_spec_hash: ebb5068064f7469f9239b18a51a6fe44
-config_hash: fd168de77f219e46a1427bbec2eecfb9
+configured_endpoints: 111
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-294ebcf6886a5ddbebeaa70923b7674757459e73ef08cd2fbc63fb70e1932eac.yml
+openapi_spec_hash: 3a2a14e7ddd646f53d9f21bef2e84ec5
+config_hash: 22f65246be4646c23dde9f69f51252e7

api.md

@@ -397,3 +397,24 @@ Methods:
 - <code title="post /v1/network-policies/{id}">client.network_policies.<a href="./src/runloop_api_client/resources/network_policies.py">update</a>(id, \*\*<a href="src/runloop_api_client/types/network_policy_update_params.py">params</a>) -> <a href="./src/runloop_api_client/types/network_policy_view.py">NetworkPolicyView</a></code>
 - <code title="get /v1/network-policies">client.network_policies.<a href="./src/runloop_api_client/resources/network_policies.py">list</a>(\*\*<a href="src/runloop_api_client/types/network_policy_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/network_policy_view.py">SyncNetworkPoliciesCursorIDPage[NetworkPolicyView]</a></code>
 - <code title="post /v1/network-policies/{id}/delete">client.network_policies.<a href="./src/runloop_api_client/resources/network_policies.py">delete</a>(id) -> <a href="./src/runloop_api_client/types/network_policy_view.py">NetworkPolicyView</a></code>
+
+# GatewayConfigs
+
+Types:
+
+```python
+from runloop_api_client.types import (
+    GatewayConfigCreateParameters,
+    GatewayConfigListView,
+    GatewayConfigUpdateParameters,
+    GatewayConfigView,
+)
+```
+
+Methods:
+
+- <code title="post /v1/gateway-configs">client.gateway_configs.<a href="./src/runloop_api_client/resources/gateway_configs.py">create</a>(\*\*<a href="src/runloop_api_client/types/gateway_config_create_params.py">params</a>) -> <a href="./src/runloop_api_client/types/gateway_config_view.py">GatewayConfigView</a></code>
+- <code title="get /v1/gateway-configs/{id}">client.gateway_configs.<a href="./src/runloop_api_client/resources/gateway_configs.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/gateway_config_view.py">GatewayConfigView</a></code>
+- <code title="post /v1/gateway-configs/{id}">client.gateway_configs.<a href="./src/runloop_api_client/resources/gateway_configs.py">update</a>(id, \*\*<a href="src/runloop_api_client/types/gateway_config_update_params.py">params</a>) -> <a href="./src/runloop_api_client/types/gateway_config_view.py">GatewayConfigView</a></code>
+- <code title="get /v1/gateway-configs">client.gateway_configs.<a href="./src/runloop_api_client/resources/gateway_configs.py">list</a>(\*\*<a href="src/runloop_api_client/types/gateway_config_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/gateway_config_view.py">SyncGatewayConfigsCursorIDPage[GatewayConfigView]</a></code>
+- <code title="post /v1/gateway-configs/{id}/delete">client.gateway_configs.<a href="./src/runloop_api_client/resources/gateway_configs.py">delete</a>(id) -> <a href="./src/runloop_api_client/types/gateway_config_view.py">GatewayConfigView</a></code>

src/runloop_api_client/_client.py

@@ -42,6 +42,7 @@
         repositories,
         benchmark_jobs,
         benchmark_runs,
+        gateway_configs,
         network_policies,
     )
     from .resources.agents import AgentsResource, AsyncAgentsResource
@@ -52,6 +53,7 @@
     from .resources.repositories import RepositoriesResource, AsyncRepositoriesResource
     from .resources.benchmark_jobs import BenchmarkJobsResource, AsyncBenchmarkJobsResource
     from .resources.benchmark_runs import BenchmarkRunsResource, AsyncBenchmarkRunsResource
+    from .resources.gateway_configs import GatewayConfigsResource, AsyncGatewayConfigsResource
     from .resources.network_policies import NetworkPoliciesResource, AsyncNetworkPoliciesResource
     from .resources.devboxes.devboxes import DevboxesResource, AsyncDevboxesResource
     from .resources.scenarios.scenarios import ScenariosResource, AsyncScenariosResource
@@ -182,6 +184,12 @@ def network_policies(self) -> NetworkPoliciesResource:
 
         return NetworkPoliciesResource(self)
 
+    @cached_property
+    def gateway_configs(self) -> GatewayConfigsResource:
+        from .resources.gateway_configs import GatewayConfigsResource
+
+        return GatewayConfigsResource(self)
+
     @cached_property
     def with_raw_response(self) -> RunloopWithRawResponse:
         return RunloopWithRawResponse(self)
@@ -418,6 +426,12 @@ def network_policies(self) -> AsyncNetworkPoliciesResource:
 
         return AsyncNetworkPoliciesResource(self)
 
+    @cached_property
+    def gateway_configs(self) -> AsyncGatewayConfigsResource:
+        from .resources.gateway_configs import AsyncGatewayConfigsResource
+
+        return AsyncGatewayConfigsResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncRunloopWithRawResponse:
         return AsyncRunloopWithRawResponse(self)
@@ -603,6 +617,12 @@ def network_policies(self) -> network_policies.NetworkPoliciesResourceWithRawRes
 
         return NetworkPoliciesResourceWithRawResponse(self._client.network_policies)
 
+    @cached_property
+    def gateway_configs(self) -> gateway_configs.GatewayConfigsResourceWithRawResponse:
+        from .resources.gateway_configs import GatewayConfigsResourceWithRawResponse
+
+        return GatewayConfigsResourceWithRawResponse(self._client.gateway_configs)
+
 
 class AsyncRunloopWithRawResponse:
     _client: AsyncRunloop
@@ -676,6 +696,12 @@ def network_policies(self) -> network_policies.AsyncNetworkPoliciesResourceWithR
 
         return AsyncNetworkPoliciesResourceWithRawResponse(self._client.network_policies)
 
+    @cached_property
+    def gateway_configs(self) -> gateway_configs.AsyncGatewayConfigsResourceWithRawResponse:
+        from .resources.gateway_configs import AsyncGatewayConfigsResourceWithRawResponse
+
+        return AsyncGatewayConfigsResourceWithRawResponse(self._client.gateway_configs)
+
 
 class RunloopWithStreamedResponse:
     _client: Runloop
@@ -749,6 +775,12 @@ def network_policies(self) -> network_policies.NetworkPoliciesResourceWithStream
 
         return NetworkPoliciesResourceWithStreamingResponse(self._client.network_policies)
 
+    @cached_property
+    def gateway_configs(self) -> gateway_configs.GatewayConfigsResourceWithStreamingResponse:
+        from .resources.gateway_configs import GatewayConfigsResourceWithStreamingResponse
+
+        return GatewayConfigsResourceWithStreamingResponse(self._client.gateway_configs)
+
 
 class AsyncRunloopWithStreamedResponse:
     _client: AsyncRunloop
@@ -822,6 +854,12 @@ def network_policies(self) -> network_policies.AsyncNetworkPoliciesResourceWithS
 
         return AsyncNetworkPoliciesResourceWithStreamingResponse(self._client.network_policies)
 
+    @cached_property
+    def gateway_configs(self) -> gateway_configs.AsyncGatewayConfigsResourceWithStreamingResponse:
+        from .resources.gateway_configs import AsyncGatewayConfigsResourceWithStreamingResponse
+
+        return AsyncGatewayConfigsResourceWithStreamingResponse(self._client.gateway_configs)
+
 
 Client = Runloop
 

src/runloop_api_client/pagination.py

@@ -30,6 +30,8 @@
     "AsyncObjectsCursorIDPage",
     "SyncNetworkPoliciesCursorIDPage",
     "AsyncNetworkPoliciesCursorIDPage",
+    "SyncGatewayConfigsCursorIDPage",
+    "AsyncGatewayConfigsCursorIDPage",
 ]
 
 _T = TypeVar("_T")
@@ -95,6 +97,11 @@ class NetworkPoliciesCursorIDPageItem(Protocol):
     id: str
 
 
+@runtime_checkable
+class GatewayConfigsCursorIDPageItem(Protocol):
+    id: str
+
+
 class SyncBlueprintsCursorIDPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
     blueprints: List[_T]
     has_more: Optional[bool] = None
@@ -909,3 +916,71 @@ def next_page_info(self) -> Optional[PageInfo]:
             return None
 
         return PageInfo(params={"starting_after": item.id})
+
+
+class SyncGatewayConfigsCursorIDPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    gateway_configs: List[_T]
+    has_more: Optional[bool] = None
+    total_count: Optional[int] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        gateway_configs = self.gateway_configs
+        if not gateway_configs:
+            return []
+        return gateway_configs
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        gateway_configs = self.gateway_configs
+        if not gateway_configs:
+            return None
+
+        item = cast(Any, gateway_configs[-1])
+        if not isinstance(item, GatewayConfigsCursorIDPageItem) or item.id is None:  # pyright: ignore[reportUnnecessaryComparison]
+            # TODO emit warning log
+            return None
+
+        return PageInfo(params={"starting_after": item.id})
+
+
+class AsyncGatewayConfigsCursorIDPage(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    gateway_configs: List[_T]
+    has_more: Optional[bool] = None
+    total_count: Optional[int] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        gateway_configs = self.gateway_configs
+        if not gateway_configs:
+            return []
+        return gateway_configs
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        gateway_configs = self.gateway_configs
+        if not gateway_configs:
+            return None
+
+        item = cast(Any, gateway_configs[-1])
+        if not isinstance(item, GatewayConfigsCursorIDPageItem) or item.id is None:  # pyright: ignore[reportUnnecessaryComparison]
+            # TODO emit warning log
+            return None
+
+        return PageInfo(params={"starting_after": item.id})

src/runloop_api_client/resources/__init__.py

@@ -80,6 +80,14 @@
     BenchmarkRunsResourceWithStreamingResponse,
     AsyncBenchmarkRunsResourceWithStreamingResponse,
 )
+from .gateway_configs import (
+    GatewayConfigsResource,
+    AsyncGatewayConfigsResource,
+    GatewayConfigsResourceWithRawResponse,
+    AsyncGatewayConfigsResourceWithRawResponse,
+    GatewayConfigsResourceWithStreamingResponse,
+    AsyncGatewayConfigsResourceWithStreamingResponse,
+)
 from .network_policies import (
     NetworkPoliciesResource,
     AsyncNetworkPoliciesResource,
@@ -156,4 +164,10 @@
     "AsyncNetworkPoliciesResourceWithRawResponse",
     "NetworkPoliciesResourceWithStreamingResponse",
     "AsyncNetworkPoliciesResourceWithStreamingResponse",
+    "GatewayConfigsResource",
+    "AsyncGatewayConfigsResource",
+    "GatewayConfigsResourceWithRawResponse",
+    "AsyncGatewayConfigsResourceWithRawResponse",
+    "GatewayConfigsResourceWithStreamingResponse",
+    "AsyncGatewayConfigsResourceWithStreamingResponse",
 ]

src/runloop_api_client/resources/devboxes/devboxes.py

@@ -185,6 +185,7 @@ def create(
         entrypoint: Optional[str] | Omit = omit,
         environment_variables: Optional[Dict[str, str]] | Omit = omit,
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
+        gateways: Optional[Dict[str, devbox_create_params.Gateways]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
         mounts: Optional[Iterable[Mount]] | Omit = omit,
@@ -227,6 +228,12 @@ def create(
 
           file_mounts: Map of paths and file contents to write before setup. Use mounts instead.
 
+          gateways: [Beta] (Optional) Gateway specifications for credential proxying. Map key is the
+              environment variable prefix (e.g., 'GWS_ANTHROPIC'). The gateway will proxy
+              requests to external APIs using the specified credential without exposing the
+              real API key. Example: {'GWS_ANTHROPIC': {'gateway': 'anthropic', 'secret':
+              'my_claude_key'}}
+
           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.
@@ -265,6 +272,7 @@ def create(
                     "entrypoint": entrypoint,
                     "environment_variables": environment_variables,
                     "file_mounts": file_mounts,
+                    "gateways": gateways,
                     "launch_parameters": launch_parameters,
                     "metadata": metadata,
                     "mounts": mounts,
@@ -1723,6 +1731,7 @@ async def create(
         entrypoint: Optional[str] | Omit = omit,
         environment_variables: Optional[Dict[str, str]] | Omit = omit,
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
+        gateways: Optional[Dict[str, devbox_create_params.Gateways]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
         mounts: Optional[Iterable[Mount]] | Omit = omit,
@@ -1765,6 +1774,12 @@ async def create(
 
           file_mounts: Map of paths and file contents to write before setup. Use mounts instead.
 
+          gateways: [Beta] (Optional) Gateway specifications for credential proxying. Map key is the
+              environment variable prefix (e.g., 'GWS_ANTHROPIC'). The gateway will proxy
+              requests to external APIs using the specified credential without exposing the
+              real API key. Example: {'GWS_ANTHROPIC': {'gateway': 'anthropic', 'secret':
+              'my_claude_key'}}
+
           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.
@@ -1803,6 +1818,7 @@ async def create(
                     "entrypoint": entrypoint,
                     "environment_variables": environment_variables,
                     "file_mounts": file_mounts,
+                    "gateways": gateways,
                     "launch_parameters": launch_parameters,
                     "metadata": metadata,
                     "mounts": mounts,