chore(stainless): generate watch_evictions as an SSE stream (#10404)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 120
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai/runloop-f18b1bba718700c841b3904207cd8ba2c066421a691845d6283bbbb361cf161d.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai/runloop-6fb96a2de54d260cad2b76366cada4eda15335275dbab7f6c108c1bb29acf309.yml
 openapi_spec_hash: 6044f4a4da13881c5f82fcc394c1f43b
-config_hash: d9a5b7a4227236a55c89de56b56f4aec
+config_hash: 92c04f0b12249cb2d2bcf9e503a9cbf9

api.md

@@ -169,6 +169,7 @@ Methods:
 Types:
 
 - <code><a href="./src/resources/devboxes/devboxes.ts">DevboxAsyncExecutionDetailView</a></code>
+- <code><a href="./src/resources/devboxes/devboxes.ts">DevboxEvictionEventView</a></code>
 - <code><a href="./src/resources/devboxes/devboxes.ts">DevboxExecutionDetailView</a></code>
 - <code><a href="./src/resources/devboxes/devboxes.ts">DevboxKillExecutionRequest</a></code>
 - <code><a href="./src/resources/devboxes/devboxes.ts">DevboxListView</a></code>
@@ -186,7 +187,6 @@ Types:
 - <code><a href="./src/resources/devboxes/devboxes.ts">DevboxReadFileContentsResponse</a></code>
 - <code><a href="./src/resources/devboxes/devboxes.ts">DevboxRemoveTunnelResponse</a></code>
 - <code><a href="./src/resources/devboxes/devboxes.ts">DevboxUploadFileResponse</a></code>
-- <code><a href="./src/resources/devboxes/devboxes.ts">DevboxWatchEvictionsResponse</a></code>
 
 Methods:
 
@@ -214,7 +214,7 @@ Methods:
 - <code title="post /v1/devboxes/{id}/suspend">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">suspend</a>(id) -> DevboxView</code>
 - <code title="post /v1/devboxes/{id}/upload_file">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">uploadFile</a>(id, { ...params }) -> unknown</code>
 - <code title="post /v1/devboxes/{devbox_id}/executions/{execution_id}/wait_for_status">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">waitForCommand</a>(devboxId, executionId, { ...params }) -> DevboxAsyncExecutionDetailView</code>
-- <code title="get /v1/devboxes/watch_evictions">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">watchEvictions</a>() -> DevboxWatchEvictionsResponse</code>
+- <code title="get /v1/devboxes/watch_evictions">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">watchEvictions</a>() -> DevboxEvictionEventView</code>
 - <code title="post /v1/devboxes/{id}/write_file_contents">client.devboxes.<a href="./src/resources/devboxes/devboxes.ts">writeFileContents</a>(id, { ...params }) -> DevboxExecutionDetailView</code>
 
 ## DiskSnapshots

src/index.ts

@@ -196,6 +196,7 @@ import {
   DevboxDeleteDiskSnapshotResponse,
   DevboxDownloadFileParams,
   DevboxEnableTunnelParams,
+  DevboxEvictionEventView,
   DevboxExecuteAsyncParams,
   DevboxExecuteParams,
   DevboxExecuteSyncParams,
@@ -223,7 +224,6 @@ import {
   DevboxView,
   DevboxViewsDevboxesCursorIDPage,
   DevboxWaitForCommandParams,
-  DevboxWatchEvictionsResponse,
   DevboxWriteFileContentsParams,
   Devboxes,
   PtyTunnelView,
@@ -674,6 +674,7 @@ export declare namespace Runloop {
   export {
     Devboxes as Devboxes,
     type DevboxAsyncExecutionDetailView as DevboxAsyncExecutionDetailView,
+    type DevboxEvictionEventView as DevboxEvictionEventView,
     type DevboxExecutionDetailView as DevboxExecutionDetailView,
     type DevboxKillExecutionRequest as DevboxKillExecutionRequest,
     type DevboxListView as DevboxListView,
@@ -691,7 +692,6 @@ export declare namespace Runloop {
     type DevboxReadFileContentsResponse as DevboxReadFileContentsResponse,
     type DevboxRemoveTunnelResponse as DevboxRemoveTunnelResponse,
     type DevboxUploadFileResponse as DevboxUploadFileResponse,
-    type DevboxWatchEvictionsResponse as DevboxWatchEvictionsResponse,
     DevboxViewsDevboxesCursorIDPage as DevboxViewsDevboxesCursorIDPage,
     DevboxSnapshotViewsDiskSnapshotsCursorIDPage as DevboxSnapshotViewsDiskSnapshotsCursorIDPage,
     type DevboxCreateParams as DevboxCreateParams,

src/resources/devboxes/devboxes.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../resource';
 import { isRequestOptions } from '../../core';
+import { APIPromise } from '../../core';
 import * as Core from '../../core';
 import * as Shared from '../shared';
 import * as DiskSnapshotsAPI from './disk-snapshots';
@@ -32,6 +33,7 @@ import {
   DiskSnapshotsCursorIDPage,
   type DiskSnapshotsCursorIDPageParams,
 } from '../../pagination';
+import { Stream } from '../../streaming';
 import { type Response } from '../../_shims/index';
 import {
   longPollUntil,
@@ -545,8 +547,10 @@ export class Devboxes extends APIResource {
    * scheduled. Best-effort and advisory: a Devbox stays running until its deadline,
    * and delivery is not guaranteed.
    */
-  watchEvictions(options?: Core.RequestOptions): Core.APIPromise<DevboxWatchEvictionsResponse> {
-    return this._client.get('/v1/devboxes/watch_evictions', options);
+  watchEvictions(options?: Core.RequestOptions): APIPromise<Stream<DevboxEvictionEventView>> {
+    return this._client.get('/v1/devboxes/watch_evictions', { ...options, stream: true }) as APIPromise<
+      Stream<DevboxEvictionEventView>
+    >;
   }
 
   /**
@@ -630,6 +634,19 @@ export interface DevboxAsyncExecutionDetailView {
   stdout_truncated?: boolean | null;
 }
 
+export interface DevboxEvictionEventView {
+  /**
+   * The ID of the Devbox with a pending eviction.
+   */
+  devbox_id: string;
+
+  /**
+   * Unix timestamp (milliseconds) after which the Devbox will be suspended. Advisory
+   * and best-effort.
+   */
+  eviction_deadline_ms: number;
+}
+
 export interface DevboxExecutionDetailView {
   /**
    * Devbox id where command was executed.
@@ -1105,19 +1122,6 @@ export type DevboxRemoveTunnelResponse = unknown;
 
 export type DevboxUploadFileResponse = unknown;
 
-export interface DevboxWatchEvictionsResponse {
-  /**
-   * The ID of the Devbox with a pending eviction.
-   */
-  devbox_id: string;
-
-  /**
-   * Unix timestamp (milliseconds) after which the Devbox will be suspended. Advisory
-   * and best-effort.
-   */
-  eviction_deadline_ms: number;
-}
-
 /**
  * Parameters for creating a new Devbox.
  *
@@ -1563,6 +1567,7 @@ Devboxes.Executions = Executions;
 export declare namespace Devboxes {
   export {
     type DevboxAsyncExecutionDetailView as DevboxAsyncExecutionDetailView,
+    type DevboxEvictionEventView as DevboxEvictionEventView,
     type DevboxExecutionDetailView as DevboxExecutionDetailView,
     type DevboxKillExecutionRequest as DevboxKillExecutionRequest,
     type DevboxListView as DevboxListView,
@@ -1580,7 +1585,6 @@ export declare namespace Devboxes {
     type DevboxReadFileContentsResponse as DevboxReadFileContentsResponse,
     type DevboxRemoveTunnelResponse as DevboxRemoveTunnelResponse,
     type DevboxUploadFileResponse as DevboxUploadFileResponse,
-    type DevboxWatchEvictionsResponse as DevboxWatchEvictionsResponse,
     DevboxViewsDevboxesCursorIDPage as DevboxViewsDevboxesCursorIDPage,
     DevboxSnapshotViewsDiskSnapshotsCursorIDPage as DevboxSnapshotViewsDiskSnapshotsCursorIDPage,
     type DevboxCreateParams as DevboxCreateParams,

src/resources/devboxes/index.ts

@@ -5,6 +5,7 @@ export {
   DevboxViewsDevboxesCursorIDPage,
   Devboxes,
   type DevboxAsyncExecutionDetailView,
+  type DevboxEvictionEventView,
   type DevboxExecutionDetailView,
   type DevboxKillExecutionRequest,
   type DevboxListView,
@@ -22,7 +23,6 @@ export {
   type DevboxReadFileContentsResponse,
   type DevboxRemoveTunnelResponse,
   type DevboxUploadFileResponse,
-  type DevboxWatchEvictionsResponse,
   type DevboxCreateParams,
   type DevboxUpdateParams,
   type DevboxListParams,

src/resources/index.ts

@@ -86,6 +86,7 @@ export {
   DevboxViewsDevboxesCursorIDPage,
   Devboxes,
   type DevboxAsyncExecutionDetailView,
+  type DevboxEvictionEventView,
   type DevboxExecutionDetailView,
   type DevboxKillExecutionRequest,
   type DevboxListView,
@@ -103,7 +104,6 @@ export {
   type DevboxReadFileContentsResponse,
   type DevboxRemoveTunnelResponse,
   type DevboxUploadFileResponse,
-  type DevboxWatchEvictionsResponse,
   type DevboxCreateParams,
   type DevboxUpdateParams,
   type DevboxListParams,

tests/api-resources/devboxes/devboxes.test.ts

@@ -607,13 +607,6 @@ describe('resource devboxes', () => {
     expect(dataAndResponse.response).toBe(rawResponse);
   });
 
-  test('watchEvictions: request options instead of params are passed correctly', async () => {
-    // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
-    await expect(client.devboxes.watchEvictions({ path: '/_stainless_unknown_path' })).rejects.toThrow(
-      Runloop.NotFoundError,
-    );
-  });
-
   test('writeFileContents: only required params', async () => {
     const responsePromise = client.devboxes.writeFileContents('id', {
       contents: 'contents',