refactor: deprecate and make Nullable total_count and remaining_count of ListViews (#7533)

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-c8d61a0c8b88fa30666ba021d1239eb0d549902354513c4741e9216bcbfa8e6d.yml
-openapi_spec_hash: 433e6fb4ce076012b696f69ae7596c67
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-8704a652545c3831c8b7e246ec17f1a626b59911eb5701ddc922ca6cae1c8d57.yml
+openapi_spec_hash: e609bc5ed3fdce498bc7d16921bbba5e
 config_hash: eb28692edd68a6ae95cf92af931c9976

api.md

@@ -160,7 +160,7 @@ Methods:
 - <code title="post /v1/devboxes/{id}/remove_tunnel">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">remove_tunnel</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_remove_tunnel_params.py">params</a>) -> object</code>
 - <code title="post /v1/devboxes/{id}/resume">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">resume</a>(id) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
 - <code title="get /v1/devboxes/{id}/usage">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">retrieve_resource_usage</a>(id) -> <a href="./src/runloop_api_client/types/devbox_resource_usage_view.py">DevboxResourceUsageView</a></code>
-- <code title="post /v1/devboxes/{id}/shutdown">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">shutdown</a>(id) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
+- <code title="post /v1/devboxes/{id}/shutdown">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">shutdown</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_shutdown_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
 - <code title="post /v1/devboxes/{id}/snapshot_disk">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">snapshot_disk</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_snapshot_disk_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_snapshot_view.py">DevboxSnapshotView</a></code>
 - <code title="post /v1/devboxes/{id}/snapshot_disk_async">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">snapshot_disk_async</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_snapshot_disk_async_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_snapshot_view.py">DevboxSnapshotView</a></code>
 - <code title="post /v1/devboxes/{id}/suspend">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">suspend</a>(id) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>

src/runloop_api_client/resources/devboxes/devboxes.py

@@ -24,6 +24,7 @@
     devbox_create_params,
     devbox_update_params,
     devbox_execute_params,
+    devbox_shutdown_params,
     devbox_upload_file_params,
     devbox_execute_sync_params,
     devbox_create_tunnel_params,
@@ -1415,6 +1416,7 @@ def shutdown(
         self,
         id: str,
         *,
+        force: str | 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,
@@ -1427,9 +1429,13 @@ def shutdown(
 
         This will permanently stop the Devbox. If you want to
         save the state of the Devbox, you should take a snapshot before shutting down or
-        should suspend the Devbox instead of shutting down.
+        should suspend the Devbox instead of shutting down. If the Devbox has any
+        in-progress snapshots, the shutdown will be rejected with a 409 Conflict unless
+        force=true is specified.
 
         Args:
+          force: If true, force shutdown even if snapshots are in progress. Defaults to false.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1450,6 +1456,7 @@ def shutdown(
                 extra_body=extra_body,
                 timeout=timeout,
                 idempotency_key=idempotency_key,
+                query=maybe_transform({"force": force}, devbox_shutdown_params.DevboxShutdownParams),
             ),
             cast_to=DevboxView,
         )
@@ -3077,6 +3084,7 @@ async def shutdown(
         self,
         id: str,
         *,
+        force: str | 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,
@@ -3089,9 +3097,13 @@ async def shutdown(
 
         This will permanently stop the Devbox. If you want to
         save the state of the Devbox, you should take a snapshot before shutting down or
-        should suspend the Devbox instead of shutting down.
+        should suspend the Devbox instead of shutting down. If the Devbox has any
+        in-progress snapshots, the shutdown will be rejected with a 409 Conflict unless
+        force=true is specified.
 
         Args:
+          force: If true, force shutdown even if snapshots are in progress. Defaults to false.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -3112,6 +3124,7 @@ async def shutdown(
                 extra_body=extra_body,
                 timeout=timeout,
                 idempotency_key=idempotency_key,
+                query=await async_maybe_transform({"force": force}, devbox_shutdown_params.DevboxShutdownParams),
             ),
             cast_to=DevboxView,
         )

src/runloop_api_client/types/__init__.py

@@ -55,6 +55,7 @@
 from .blueprint_list_params import BlueprintListParams as BlueprintListParams
 from .devbox_execute_params import DevboxExecuteParams as DevboxExecuteParams
 from .blueprint_preview_view import BlueprintPreviewView as BlueprintPreviewView
+from .devbox_shutdown_params import DevboxShutdownParams as DevboxShutdownParams
 from .mcp_config_list_params import McpConfigListParams as McpConfigListParams
 from .object_download_params import ObjectDownloadParams as ObjectDownloadParams
 from .repository_list_params import RepositoryListParams as RepositoryListParams

src/runloop_api_client/types/agent_list_view.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List
+from typing import List, Optional
 
 from .._models import BaseModel
 from .agent_view import AgentView
@@ -17,8 +17,14 @@ class AgentListView(BaseModel):
     has_more: bool
     """Whether there are more Agents to fetch."""
 
-    remaining_count: int
-    """The count of remaining Agents."""
+    remaining_count: Optional[int] = None
+    """The count of remaining Agents.
 
-    total_count: int
-    """The total count of Agents."""
+    Deprecated: will be removed in a future breaking change.
+    """
+
+    total_count: Optional[int] = None
+    """The total count of Agents.
+
+    Deprecated: will be removed in a future breaking change.
+    """

src/runloop_api_client/types/benchmark_job_list_view.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List
+from typing import List, Optional
 
 from .._models import BaseModel
 from .benchmark_job_view import BenchmarkJobView
@@ -14,6 +14,6 @@ class BenchmarkJobListView(BaseModel):
     jobs: List[BenchmarkJobView]
     """List of BenchmarkJobs matching filter."""
 
-    remaining_count: int
+    remaining_count: Optional[int] = None
 
-    total_count: int
+    total_count: Optional[int] = None

src/runloop_api_client/types/benchmark_run_list_view.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List
+from typing import List, Optional
 
 from .._models import BaseModel
 from .benchmark_run_view import BenchmarkRunView
@@ -11,9 +11,9 @@
 class BenchmarkRunListView(BaseModel):
     has_more: bool
 
-    remaining_count: int
-
     runs: List[BenchmarkRunView]
     """List of BenchmarkRuns matching filter."""
 
-    total_count: int
+    remaining_count: Optional[int] = None
+
+    total_count: Optional[int] = None

src/runloop_api_client/types/blueprint_list_view.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List
+from typing import List, Optional
 
 from .._models import BaseModel
 from .blueprint_view import BlueprintView
@@ -14,6 +14,6 @@ class BlueprintListView(BaseModel):
 
     has_more: bool
 
-    remaining_count: int
+    remaining_count: Optional[int] = None
 
-    total_count: int
+    total_count: Optional[int] = None

src/runloop_api_client/types/devbox_list_view.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List
+from typing import List, Optional
 
 from .._models import BaseModel
 from .devbox_view import DevboxView
@@ -14,6 +14,6 @@ class DevboxListView(BaseModel):
 
     has_more: bool
 
-    remaining_count: int
+    remaining_count: Optional[int] = None
 
-    total_count: int
+    total_count: Optional[int] = None

src/runloop_api_client/types/devbox_shutdown_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["DevboxShutdownParams"]
+
+
+class DevboxShutdownParams(TypedDict, total=False):
+    force: str
+    """If true, force shutdown even if snapshots are in progress. Defaults to false."""