feat: Return uptime_ms for deleted browser sessions

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 101
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-e6e88da6e6fffe12873a108ca33ebfbd59b85232078ab0e4dca5c8273c131053.yml
-openapi_spec_hash: 4f22b8ec1d048cc74a751e3ab39b943c
-config_hash: 6bac5bbe5d5fc26e0912e33f646adb14
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-586ddc36cd621b3705138de66a0e7d28d1c1485064aa85ce09ce24edb50003ef.yml
+openapi_spec_hash: 8e8d4bd31e4920303e7ec9ce313fb1ec
+config_hash: 81f143f4bee47ae7b0b8357551babadf

api.md

@@ -68,6 +68,7 @@ Types:
 
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserPersistence</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserPoolRef</a></code>
+- <code><a href="./src/resources/browsers/browsers.ts">BrowserUsage</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">Profile</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserCreateResponse</a></code>
 - <code><a href="./src/resources/browsers/browsers.ts">BrowserRetrieveResponse</a></code>

src/client.ts

@@ -112,6 +112,7 @@ import {
   BrowserRetrieveResponse,
   BrowserUpdateParams,
   BrowserUpdateResponse,
+  BrowserUsage,
   Browsers,
   Profile,
 } from './resources/browsers/browsers';
@@ -971,6 +972,7 @@ export declare namespace Kernel {
     Browsers as Browsers,
     type BrowserPersistence as BrowserPersistence,
     type BrowserPoolRef as BrowserPoolRef,
+    type BrowserUsage as BrowserUsage,
     type Profile as Profile,
     type BrowserCreateResponse as BrowserCreateResponse,
     type BrowserRetrieveResponse as BrowserRetrieveResponse,

src/resources/browser-pools.ts

@@ -327,6 +327,11 @@ export interface BrowserPoolAcquireResponse {
    */
   proxy_id?: string;
 
+  /**
+   * Session usage metrics.
+   */
+  usage?: BrowsersAPI.BrowserUsage;
+
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
    * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,

src/resources/browsers/browsers.ts

@@ -237,6 +237,16 @@ export interface BrowserPoolRef {
   name?: string;
 }
 
+/**
+ * Session usage metrics.
+ */
+export interface BrowserUsage {
+  /**
+   * Time in milliseconds the session was actively running.
+   */
+  uptime_ms: number;
+}
+
 /**
  * Browser profile metadata.
  */
@@ -340,6 +350,11 @@ export interface BrowserCreateResponse {
    */
   proxy_id?: string;
 
+  /**
+   * Session usage metrics.
+   */
+  usage?: BrowserUsage;
+
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
    * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
@@ -426,6 +441,11 @@ export interface BrowserRetrieveResponse {
    */
   proxy_id?: string;
 
+  /**
+   * Session usage metrics.
+   */
+  usage?: BrowserUsage;
+
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
    * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
@@ -512,6 +532,11 @@ export interface BrowserUpdateResponse {
    */
   proxy_id?: string;
 
+  /**
+   * Session usage metrics.
+   */
+  usage?: BrowserUsage;
+
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
    * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
@@ -598,6 +623,11 @@ export interface BrowserListResponse {
    */
   proxy_id?: string;
 
+  /**
+   * Session usage metrics.
+   */
+  usage?: BrowserUsage;
+
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
    * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,
@@ -772,6 +802,7 @@ export declare namespace Browsers {
   export {
     type BrowserPersistence as BrowserPersistence,
     type BrowserPoolRef as BrowserPoolRef,
+    type BrowserUsage as BrowserUsage,
     type Profile as Profile,
     type BrowserCreateResponse as BrowserCreateResponse,
     type BrowserRetrieveResponse as BrowserRetrieveResponse,

src/resources/browsers/index.ts

@@ -4,6 +4,7 @@ export {
   Browsers,
   type BrowserPersistence,
   type BrowserPoolRef,
+  type BrowserUsage,
   type Profile,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,

src/resources/index.ts

@@ -23,6 +23,7 @@ export {
   Browsers,
   type BrowserPersistence,
   type BrowserPoolRef,
+  type BrowserUsage,
   type Profile,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,

src/resources/invocations.ts

@@ -487,6 +487,11 @@ export namespace InvocationListBrowsersResponse {
      */
     proxy_id?: string;
 
+    /**
+     * Session usage metrics.
+     */
+    usage?: BrowsersAPI.BrowserUsage;
+
     /**
      * Initial browser window size in pixels with optional refresh rate. If omitted,
      * image defaults apply (1920x1080@25). Arbitrary viewport dimensions are accepted,