feat: Add opt-in record_session flag to managed auth

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 112
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-38c6ce8b0ce54e6c62517b9635acaf65369c26cdb1b55eb66290c13a8ab2b33d.yml
-openapi_spec_hash: e6f6ed157b1e318d1a1db72fd1d27091
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-64dac369ae935b0318cd611e1735d45359a663eb55cf43fbb8b09e9dd814d7a2.yml
+openapi_spec_hash: cc0c6a4e716977df4b9eab5f4658d41b
 config_hash: 08d55086449943a8fec212b870061a3f

src/resources/auth/connections.ts

@@ -212,6 +212,12 @@ export interface ManagedAuth {
    */
   profile_name: string;
 
+  /**
+   * Whether browser sessions for this connection are recorded by default for
+   * debugging. Can be overridden per-login.
+   */
+  record_session: boolean;
+
   /**
    * Whether credentials are saved after every successful login. One-time codes
    * (TOTP, SMS, etc.) are not saved.
@@ -614,6 +620,12 @@ export interface ManagedAuthCreateRequest {
    */
   proxy?: ManagedAuthCreateRequest.Proxy;
 
+  /**
+   * Whether to record browser sessions for this connection by default. Useful for
+   * debugging. Can be overridden per-login. Defaults to false.
+   */
+  record_session?: boolean;
+
   /**
    * Whether to save credentials after every successful login. Defaults to true.
    * One-time codes (TOTP, SMS, etc.) are not saved.
@@ -702,6 +714,11 @@ export interface ManagedAuthUpdateRequest {
    */
   proxy?: ManagedAuthUpdateRequest.Proxy;
 
+  /**
+   * Whether to record browser sessions for this connection by default
+   */
+  record_session?: boolean;
+
   /**
    * Whether to save credentials after every successful login
    */
@@ -1080,6 +1097,12 @@ export interface ConnectionCreateParams {
    */
   proxy?: ConnectionCreateParams.Proxy;
 
+  /**
+   * Whether to record browser sessions for this connection by default. Useful for
+   * debugging. Can be overridden per-login. Defaults to false.
+   */
+  record_session?: boolean;
+
   /**
    * Whether to save credentials after every successful login. Defaults to true.
    * One-time codes (TOTP, SMS, etc.) are not saved.
@@ -1165,6 +1188,11 @@ export interface ConnectionUpdateParams {
    */
   proxy?: ConnectionUpdateParams.Proxy;
 
+  /**
+   * Whether to record browser sessions for this connection by default
+   */
+  record_session?: boolean;
+
   /**
    * Whether to save credentials after every successful login
    */
@@ -1236,6 +1264,12 @@ export interface ConnectionLoginParams {
    * caller's org.
    */
   proxy?: ConnectionLoginParams.Proxy;
+
+  /**
+   * Override the connection's default for recording this login's browser session.
+   * When omitted, the connection's record_session default is used.
+   */
+  record_session?: boolean;
 }
 
 export namespace ConnectionLoginParams {

tests/api-resources/auth/connections.test.ts

@@ -38,6 +38,7 @@ describe('resource connections', () => {
       health_check_interval: 3600,
       login_url: 'https://netflix.com/login',
       proxy: { id: 'id', name: 'name' },
+      record_session: false,
       save_credentials: true,
     });
   });
@@ -136,7 +137,10 @@ describe('resource connections', () => {
     await expect(
       client.auth.connections.login(
         'id',
-        { proxy: { id: 'id', name: 'name' } },
+        {
+          proxy: { id: 'id', name: 'name' },
+          record_session: true,
+        },
         { path: '/_stainless_unknown_path' },
       ),
     ).rejects.toThrow(Kernel.NotFoundError);