feat: Add stainless CI

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 46
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-cb38560915edce03abce2ae3ef5bc745489dbe9b6f80c2b4ff42edf8c2ff276d.yml
-openapi_spec_hash: a869194d6c864ba28d79ec0105439c3e
-config_hash: ed56f95781ec9b2e73c97e1a66606071
+configured_endpoints: 50
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-d3a597bbbb25c131e2c06eb9b47d70932d14a97a6f916677a195a128e196f4db.yml
+openapi_spec_hash: c967b384624017eed0abff1b53a74530
+config_hash: 0d150b61cae2dc57d3648ceae7784966

api.md

@@ -160,3 +160,18 @@ Methods:
 - <code title="get /profiles">client.profiles.<a href="./src/resources/profiles.ts">list</a>() -> ProfileListResponse</code>
 - <code title="delete /profiles/{id_or_name}">client.profiles.<a href="./src/resources/profiles.ts">delete</a>(idOrName) -> void</code>
 - <code title="get /profiles/{id_or_name}/download">client.profiles.<a href="./src/resources/profiles.ts">download</a>(idOrName) -> Response</code>
+
+# Proxies
+
+Types:
+
+- <code><a href="./src/resources/proxies.ts">ProxyCreateResponse</a></code>
+- <code><a href="./src/resources/proxies.ts">ProxyRetrieveResponse</a></code>
+- <code><a href="./src/resources/proxies.ts">ProxyListResponse</a></code>
+
+Methods:
+
+- <code title="post /proxies">client.proxies.<a href="./src/resources/proxies.ts">create</a>({ ...params }) -> ProxyCreateResponse</code>
+- <code title="get /proxies/{id}">client.proxies.<a href="./src/resources/proxies.ts">retrieve</a>(id) -> ProxyRetrieveResponse</code>
+- <code title="get /proxies">client.proxies.<a href="./src/resources/proxies.ts">list</a>() -> ProxyListResponse</code>
+- <code title="delete /proxies/{id}">client.proxies.<a href="./src/resources/proxies.ts">delete</a>(id) -> void</code>

src/client.ts

@@ -43,6 +43,13 @@ import {
   Invocations,
 } from './resources/invocations';
 import { ProfileCreateParams, ProfileListResponse, Profiles } from './resources/profiles';
+import {
+  Proxies,
+  ProxyCreateParams,
+  ProxyCreateResponse,
+  ProxyListResponse,
+  ProxyRetrieveResponse,
+} from './resources/proxies';
 import {
   BrowserCreateParams,
   BrowserCreateResponse,
@@ -820,13 +827,15 @@ export class Kernel {
   invocations: API.Invocations = new API.Invocations(this);
   browsers: API.Browsers = new API.Browsers(this);
   profiles: API.Profiles = new API.Profiles(this);
+  proxies: API.Proxies = new API.Proxies(this);
 }
 
 Kernel.Deployments = Deployments;
 Kernel.Apps = Apps;
 Kernel.Invocations = Invocations;
 Kernel.Browsers = Browsers;
 Kernel.Profiles = Profiles;
+Kernel.Proxies = Proxies;
 
 export declare namespace Kernel {
   export type RequestOptions = Opts.RequestOptions;
@@ -880,6 +889,14 @@ export declare namespace Kernel {
     type ProfileCreateParams as ProfileCreateParams,
   };
 
+  export {
+    Proxies as Proxies,
+    type ProxyCreateResponse as ProxyCreateResponse,
+    type ProxyRetrieveResponse as ProxyRetrieveResponse,
+    type ProxyListResponse as ProxyListResponse,
+    type ProxyCreateParams as ProxyCreateParams,
+  };
+
   export type AppAction = API.AppAction;
   export type ErrorDetail = API.ErrorDetail;
   export type ErrorEvent = API.ErrorEvent;

src/resources/browsers/browsers.ts

@@ -348,6 +348,12 @@ export interface BrowserCreateParams {
    */
   profile?: BrowserCreateParams.Profile;
 
+  /**
+   * Optional proxy to associate to the browser session. Must reference a proxy
+   * belonging to the caller's org.
+   */
+  proxy_id?: string;
+
   /**
    * If true, launches the browser in stealth mode to reduce detection by anti-bot
    * mechanisms.
@@ -357,7 +363,10 @@ export interface BrowserCreateParams {
   /**
    * The number of seconds of inactivity before the browser session is terminated.
    * Only applicable to non-persistent browsers. Activity includes CDP connections
-   * and live view connections. Defaults to 60 seconds.
+   * and live view connections. Defaults to 60 seconds. Minimum allowed is 10
+   * seconds. Maximum allowed is 86400 (24 hours). We check for inactivity every 5
+   * seconds, so the actual timeout behavior you will see is +/- 5 seconds around the
+   * specified value.
    */
   timeout_seconds?: number;
 }

src/resources/index.ts

@@ -35,3 +35,10 @@ export {
   type InvocationUpdateParams,
 } from './invocations';
 export { Profiles, type ProfileListResponse, type ProfileCreateParams } from './profiles';
+export {
+  Proxies,
+  type ProxyCreateResponse,
+  type ProxyRetrieveResponse,
+  type ProxyListResponse,
+  type ProxyCreateParams,
+} from './proxies';

src/resources/invocations.ts

@@ -40,7 +40,8 @@ export class Invocations extends APIResource {
   }
 
   /**
-   * Update an invocation's status or output.
+   * Update an invocation's status or output. This can used to cancel an invocation
+   * by setting the status to "failed".
    *
    * @example
    * ```ts