chore: Add archive method to stainless (#7537)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 117
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-1ee005e7d8f97067abb96c6a38af53b69d362f2511ca775a9b78580a9643c253.yml
-openapi_spec_hash: 9c54d19abf7993fd55714759f3265f9c
-config_hash: eb28692edd68a6ae95cf92af931c9976
+configured_endpoints: 118
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-1a92de99959f20ab5850a7f89db21cb66269b2e0002ffc5e5afbe660d05b0768.yml
+openapi_spec_hash: 41e4660f26e27e6ab94d223da4ec1253
+config_hash: cbda3692cb48ab8582a0df1674b9e5c8

api.md

@@ -277,6 +277,7 @@ Methods:
 - <code title="get /v1/scenarios/{id}">client.scenarios.<a href="./src/runloop_api_client/resources/scenarios/scenarios.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/scenario_view.py">ScenarioView</a></code>
 - <code title="post /v1/scenarios/{id}">client.scenarios.<a href="./src/runloop_api_client/resources/scenarios/scenarios.py">update</a>(id, \*\*<a href="src/runloop_api_client/types/scenario_update_params.py">params</a>) -> <a href="./src/runloop_api_client/types/scenario_view.py">ScenarioView</a></code>
 - <code title="get /v1/scenarios">client.scenarios.<a href="./src/runloop_api_client/resources/scenarios/scenarios.py">list</a>(\*\*<a href="src/runloop_api_client/types/scenario_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/scenario_view.py">SyncScenariosCursorIDPage[ScenarioView]</a></code>
+- <code title="post /v1/scenarios/{id}/archive">client.scenarios.<a href="./src/runloop_api_client/resources/scenarios/scenarios.py">archive</a>(id) -> <a href="./src/runloop_api_client/types/scenario_view.py">ScenarioView</a></code>
 - <code title="get /v1/scenarios/list_public">client.scenarios.<a href="./src/runloop_api_client/resources/scenarios/scenarios.py">list_public</a>(\*\*<a href="src/runloop_api_client/types/scenario_list_public_params.py">params</a>) -> <a href="./src/runloop_api_client/types/scenario_view.py">SyncScenariosCursorIDPage[ScenarioView]</a></code>
 - <code title="post /v1/scenarios/start_run">client.scenarios.<a href="./src/runloop_api_client/resources/scenarios/scenarios.py">start_run</a>(\*\*<a href="src/runloop_api_client/types/scenario_start_run_params.py">params</a>) -> <a href="./src/runloop_api_client/types/scenario_run_view.py">ScenarioRunView</a></code>
 

src/runloop_api_client/resources/devboxes/devboxes.py

@@ -807,6 +807,7 @@ def enable_tunnel(
         id: str,
         *,
         auth_mode: Optional[Literal["open", "authenticated"]] | Omit = omit,
+        http_keep_alive: Optional[bool] | Omit = omit,
         # 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,
@@ -826,6 +827,9 @@ def enable_tunnel(
         Args:
           auth_mode: Authentication mode for the tunnel. Defaults to 'public' if not specified.
 
+          http_keep_alive: When true, HTTP traffic through the tunnel counts as activity for idle lifecycle
+              policies, resetting the idle timer. Defaults to true if not specified.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -840,7 +844,13 @@ def enable_tunnel(
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         return self._post(
             f"/v1/devboxes/{id}/enable_tunnel",
-            body=maybe_transform({"auth_mode": auth_mode}, devbox_enable_tunnel_params.DevboxEnableTunnelParams),
+            body=maybe_transform(
+                {
+                    "auth_mode": auth_mode,
+                    "http_keep_alive": http_keep_alive,
+                },
+                devbox_enable_tunnel_params.DevboxEnableTunnelParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -2472,6 +2482,7 @@ async def enable_tunnel(
         id: str,
         *,
         auth_mode: Optional[Literal["open", "authenticated"]] | Omit = omit,
+        http_keep_alive: Optional[bool] | Omit = omit,
         # 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,
@@ -2491,6 +2502,9 @@ async def enable_tunnel(
         Args:
           auth_mode: Authentication mode for the tunnel. Defaults to 'public' if not specified.
 
+          http_keep_alive: When true, HTTP traffic through the tunnel counts as activity for idle lifecycle
+              policies, resetting the idle timer. Defaults to true if not specified.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -2506,7 +2520,11 @@ async def enable_tunnel(
         return await self._post(
             f"/v1/devboxes/{id}/enable_tunnel",
             body=await async_maybe_transform(
-                {"auth_mode": auth_mode}, devbox_enable_tunnel_params.DevboxEnableTunnelParams
+                {
+                    "auth_mode": auth_mode,
+                    "http_keep_alive": http_keep_alive,
+                },
+                devbox_enable_tunnel_params.DevboxEnableTunnelParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers,

src/runloop_api_client/resources/scenarios/scenarios.py

@@ -353,6 +353,48 @@ def list(
             model=ScenarioView,
         )
 
+    def archive(
+        self,
+        id: str,
+        *,
+        # 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,
+    ) -> ScenarioView:
+        """Archive a previously created Scenario.
+
+        The scenario will no longer appear in
+        list endpoints but can still be retrieved by ID.
+
+        Args:
+          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
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._post(
+            f"/v1/scenarios/{id}/archive",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=ScenarioView,
+        )
+
     def list_public(
         self,
         *,
@@ -823,6 +865,48 @@ def list(
             model=ScenarioView,
         )
 
+    async def archive(
+        self,
+        id: str,
+        *,
+        # 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,
+    ) -> ScenarioView:
+        """Archive a previously created Scenario.
+
+        The scenario will no longer appear in
+        list endpoints but can still be retrieved by ID.
+
+        Args:
+          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
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._post(
+            f"/v1/scenarios/{id}/archive",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=ScenarioView,
+        )
+
     def list_public(
         self,
         *,
@@ -1005,6 +1089,9 @@ def __init__(self, scenarios: ScenariosResource) -> None:
         self.list = to_raw_response_wrapper(
             scenarios.list,
         )
+        self.archive = to_raw_response_wrapper(
+            scenarios.archive,
+        )
         self.list_public = to_raw_response_wrapper(
             scenarios.list_public,
         )
@@ -1037,6 +1124,9 @@ def __init__(self, scenarios: AsyncScenariosResource) -> None:
         self.list = async_to_raw_response_wrapper(
             scenarios.list,
         )
+        self.archive = async_to_raw_response_wrapper(
+            scenarios.archive,
+        )
         self.list_public = async_to_raw_response_wrapper(
             scenarios.list_public,
         )
@@ -1069,6 +1159,9 @@ def __init__(self, scenarios: ScenariosResource) -> None:
         self.list = to_streamed_response_wrapper(
             scenarios.list,
         )
+        self.archive = to_streamed_response_wrapper(
+            scenarios.archive,
+        )
         self.list_public = to_streamed_response_wrapper(
             scenarios.list_public,
         )
@@ -1101,6 +1194,9 @@ def __init__(self, scenarios: AsyncScenariosResource) -> None:
         self.list = async_to_streamed_response_wrapper(
             scenarios.list,
         )
+        self.archive = async_to_streamed_response_wrapper(
+            scenarios.archive,
+        )
         self.list_public = async_to_streamed_response_wrapper(
             scenarios.list_public,
         )

src/runloop_api_client/types/devbox_create_params.py

@@ -142,3 +142,9 @@ class Tunnel(TypedDict, total=False):
 
     auth_mode: Optional[Literal["open", "authenticated"]]
     """Authentication mode for the tunnel. Defaults to 'public' if not specified."""
+
+    http_keep_alive: Optional[bool]
+    """
+    When true, HTTP traffic through the tunnel counts as activity for idle lifecycle
+    policies, resetting the idle timer. Defaults to true if not specified.
+    """

src/runloop_api_client/types/devbox_enable_tunnel_params.py

@@ -11,3 +11,9 @@
 class DevboxEnableTunnelParams(TypedDict, total=False):
     auth_mode: Optional[Literal["open", "authenticated"]]
     """Authentication mode for the tunnel. Defaults to 'public' if not specified."""
+
+    http_keep_alive: Optional[bool]
+    """
+    When true, HTTP traffic through the tunnel counts as activity for idle lifecycle
+    policies, resetting the idle timer. Defaults to true if not specified.
+    """

src/runloop_api_client/types/tunnel_view.py

@@ -21,6 +21,12 @@ class TunnelView(BaseModel):
     create_time_ms: int
     """Creation time of the tunnel (Unix timestamp milliseconds)."""
 
+    http_keep_alive: bool
+    """
+    When true, HTTP traffic through the tunnel counts as activity for idle lifecycle
+    policies, resetting the idle timer.
+    """
+
     tunnel_key: str
     """The encrypted tunnel key used to construct the tunnel URL.
 

tests/api_resources/test_devboxes.py

@@ -111,7 +111,10 @@ def test_method_create_with_all_params(self, client: Runloop) -> None:
             repo_connection_id="repo_connection_id",
             secrets={"foo": "string"},
             snapshot_id="snapshot_id",
-            tunnel={"auth_mode": "open"},
+            tunnel={
+                "auth_mode": "open",
+                "http_keep_alive": True,
+            },
         )
         assert_matches_type(DevboxView, devbox, path=["response"])
 
@@ -447,6 +450,7 @@ def test_method_enable_tunnel_with_all_params(self, client: Runloop) -> None:
         devbox = client.devboxes.enable_tunnel(
             id="id",
             auth_mode="open",
+            http_keep_alive=True,
         )
         assert_matches_type(TunnelView, devbox, path=["response"])
 
@@ -1775,7 +1779,10 @@ async def test_method_create_with_all_params(self, async_client: AsyncRunloop) -
             repo_connection_id="repo_connection_id",
             secrets={"foo": "string"},
             snapshot_id="snapshot_id",
-            tunnel={"auth_mode": "open"},
+            tunnel={
+                "auth_mode": "open",
+                "http_keep_alive": True,
+            },
         )
         assert_matches_type(DevboxView, devbox, path=["response"])
 
@@ -2111,6 +2118,7 @@ async def test_method_enable_tunnel_with_all_params(self, async_client: AsyncRun
         devbox = await async_client.devboxes.enable_tunnel(
             id="id",
             auth_mode="open",
+            http_keep_alive=True,
         )
         assert_matches_type(TunnelView, devbox, path=["response"])
 

tests/api_resources/test_scenarios.py

@@ -319,6 +319,44 @@ def test_streaming_response_list(self, client: Runloop) -> None:
 
         assert cast(Any, response.is_closed) is True
 
+    @parametrize
+    def test_method_archive(self, client: Runloop) -> None:
+        scenario = client.scenarios.archive(
+            "id",
+        )
+        assert_matches_type(ScenarioView, scenario, path=["response"])
+
+    @parametrize
+    def test_raw_response_archive(self, client: Runloop) -> None:
+        response = client.scenarios.with_raw_response.archive(
+            "id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        scenario = response.parse()
+        assert_matches_type(ScenarioView, scenario, path=["response"])
+
+    @parametrize
+    def test_streaming_response_archive(self, client: Runloop) -> None:
+        with client.scenarios.with_streaming_response.archive(
+            "id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            scenario = response.parse()
+            assert_matches_type(ScenarioView, scenario, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_archive(self, client: Runloop) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            client.scenarios.with_raw_response.archive(
+                "",
+            )
+
     @parametrize
     def test_method_list_public(self, client: Runloop) -> None:
         scenario = client.scenarios.list_public()
@@ -730,6 +768,44 @@ async def test_streaming_response_list(self, async_client: AsyncRunloop) -> None
 
         assert cast(Any, response.is_closed) is True
 
+    @parametrize
+    async def test_method_archive(self, async_client: AsyncRunloop) -> None:
+        scenario = await async_client.scenarios.archive(
+            "id",
+        )
+        assert_matches_type(ScenarioView, scenario, path=["response"])
+
+    @parametrize
+    async def test_raw_response_archive(self, async_client: AsyncRunloop) -> None:
+        response = await async_client.scenarios.with_raw_response.archive(
+            "id",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        scenario = await response.parse()
+        assert_matches_type(ScenarioView, scenario, path=["response"])
+
+    @parametrize
+    async def test_streaming_response_archive(self, async_client: AsyncRunloop) -> None:
+        async with async_client.scenarios.with_streaming_response.archive(
+            "id",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            scenario = await response.parse()
+            assert_matches_type(ScenarioView, scenario, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_archive(self, async_client: AsyncRunloop) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            await async_client.scenarios.with_raw_response.archive(
+                "",
+            )
+
     @parametrize
     async def test_method_list_public(self, async_client: AsyncRunloop) -> None:
         scenario = await async_client.scenarios.list_public()