@onkernel/sdk 0.48.0 → 0.51.0

package/src/resources/auth/connections.ts

@@ -244,6 +244,13 @@ export interface ManagedAuth {
    */
   allowed_domains?: Array<string>;
 
+  /**
+   * ID of the underlying browser session driving the current flow (present when flow
+   * in progress). Use this to inspect or terminate the browser session via the
+   * `/browsers` API.
+   */
+  browser_session_id?: string | null;
+
   /**
    * Whether automatic re-authentication is possible (has credential, selectors, and
    * login_url)
@@ -286,7 +293,10 @@ export interface ManagedAuth {
   external_action_message?: string | null;
 
   /**
-   * When the current flow expires (null when no flow in progress)
+   * When the current flow expires (null when no flow in progress). A flow past this
+   * timestamp is no longer valid and its `flow_status` will be `EXPIRED`. Clients
+   * may start a new login to supersede a stale `IN_PROGRESS` flow past this
+   * timestamp.
    */
   flow_expires_at?: string | null;
 
@@ -326,10 +336,21 @@ export interface ManagedAuth {
   hosted_url?: string | null;
 
   /**
-   * When the profile was last successfully authenticated
+   * @deprecated Deprecated alias for `last_auth_check_at`. Despite the name, this is
+   * the last health-check timestamp, not the last successful authentication. Use
+   * `last_auth_check_at` instead.
    */
   last_auth_at?: string;
 
+  /**
+   * When the most recent auth health check ran for this connection, regardless of
+   * outcome. Updated on every health check and does not by itself indicate that the
+   * profile is currently authenticated - use `status` for that. May be newer than
+   * `flow_expires_at` when a flow is still in progress because health checks
+   * continue to run in parallel.
+   */
+  last_auth_check_at?: string;
+
   /**
    * Browser live view URL for debugging (present when flow in progress)
    */
@@ -433,6 +454,12 @@ export namespace ManagedAuth {
      */
     type: 'text' | 'email' | 'password' | 'tel' | 'number' | 'url' | 'code' | 'totp';
 
+    /**
+     * Contextual help text near the field that tells the user what to enter (e.g.,
+     * "Enter the phone ending in (**_) _**-\*\*92")
+     */
+    hint?: string;
+
     /**
      * If this field is associated with an MFA option, the type of that option (e.g.,
      * password field linked to "Enter password" option)
@@ -890,6 +917,12 @@ export namespace ConnectionFollowResponse {
        */
       type: 'text' | 'email' | 'password' | 'tel' | 'number' | 'url' | 'code' | 'totp';
 
+      /**
+       * Contextual help text near the field that tells the user what to enter (e.g.,
+       * "Enter the phone ending in (**_) _**-\*\*92")
+       */
+      hint?: string;
+
       /**
        * If this field is associated with an MFA option, the type of that option (e.g.,
        * password field linked to "Enter password" option)

package/src/resources/browsers/browsers.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import type { RequestInfo } from '../../internal/builtin-types';
 import { APIResource } from '../../core/resource';
 import * as Shared from '../shared';
 import * as ComputerAPI from './computer';
@@ -75,6 +76,7 @@ import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { multipartFormRequestOptions } from '../../internal/uploads';
 import { path } from '../../internal/utils/path';
+import { browserFetch, type BrowserFetchInit } from '../../lib/browser-fetch';
 
 /**
  * Create and manage browser sessions.
@@ -168,6 +170,30 @@ export class Browsers extends APIResource {
     });
   }
 
+  /**
+   * Sends an HTTP request through Chrome's HTTP request stack, inheriting the
+   * browser's TLS fingerprint, cookies, proxy configuration, and headers. Returns a
+   * structured JSON response with status, headers, body, and timing.
+   *
+   * @example
+   * ```ts
+   * const response = await client.browsers.curl('id', {
+   *   url: 'url',
+   * });
+   * ```
+   */
+  curl(id: string, body: BrowserCurlParams, options?: RequestOptions): APIPromise<BrowserCurlResponse> {
+    return this._client.post(path`/browsers/${id}/curl`, { body, ...options });
+  }
+
+  /**
+   * Issues an HTTP request through the browser VM network stack, routing directly
+   * to the browser's `base_url` using the shared browser route cache.
+   */
+  fetch(id: string, input: RequestInfo | URL, init?: BrowserFetchInit): Promise<Response> {
+    return browserFetch(this._client, id, input, init);
+  }
+
   /**
    * Delete a browser session by ID
    *
@@ -706,6 +732,31 @@ export interface BrowserListResponse {
   viewport?: Shared.BrowserViewport;
 }
 
+/**
+ * Structured response from the browser curl request.
+ */
+export interface BrowserCurlResponse {
+  /**
+   * Response body (UTF-8 string or base64 depending on request).
+   */
+  body: string;
+
+  /**
+   * Total request duration in milliseconds.
+   */
+  duration_ms: number;
+
+  /**
+   * Response headers (multi-value).
+   */
+  headers: { [key: string]: Array<string> };
+
+  /**
+   * HTTP status code from target.
+   */
+  status: number;
+}
+
 export interface BrowserCreateParams {
   /**
    * List of browser extensions to load into the session. Provide each by id or name.
@@ -841,7 +892,7 @@ export interface BrowserListParams extends OffsetPaginationParams {
   include_deleted?: boolean;
 
   /**
-   * Search browsers by session ID, profile ID, or proxy ID.
+   * Search browsers by session ID, profile ID, proxy ID, or pool name.
    */
   query?: string;
 
@@ -859,6 +910,38 @@ export interface BrowserDeleteParams {
   persistent_id: string;
 }
 
+export interface BrowserCurlParams {
+  /**
+   * Target URL (must be http or https).
+   */
+  url: string;
+
+  /**
+   * Request body (for POST/PUT/PATCH).
+   */
+  body?: string;
+
+  /**
+   * Custom headers merged with browser defaults.
+   */
+  headers?: { [key: string]: string };
+
+  /**
+   * HTTP method.
+   */
+  method?: 'GET' | 'HEAD' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS';
+
+  /**
+   * Encoding for the response body. Use base64 for binary content.
+   */
+  response_encoding?: 'utf8' | 'base64';
+
+  /**
+   * Request timeout in milliseconds.
+   */
+  timeout_ms?: number;
+}
+
 export interface BrowserLoadExtensionsParams {
   /**
    * List of extensions to upload and activate
@@ -898,12 +981,14 @@ export declare namespace Browsers {
     type BrowserRetrieveResponse as BrowserRetrieveResponse,
     type BrowserUpdateResponse as BrowserUpdateResponse,
     type BrowserListResponse as BrowserListResponse,
+    type BrowserCurlResponse as BrowserCurlResponse,
     type BrowserListResponsesOffsetPagination as BrowserListResponsesOffsetPagination,
     type BrowserCreateParams as BrowserCreateParams,
     type BrowserRetrieveParams as BrowserRetrieveParams,
     type BrowserUpdateParams as BrowserUpdateParams,
     type BrowserListParams as BrowserListParams,
     type BrowserDeleteParams as BrowserDeleteParams,
+    type BrowserCurlParams as BrowserCurlParams,
     type BrowserLoadExtensionsParams as BrowserLoadExtensionsParams,
   };
 

package/src/resources/browsers/index.ts

@@ -10,11 +10,13 @@ export {
   type BrowserRetrieveResponse,
   type BrowserUpdateResponse,
   type BrowserListResponse,
+  type BrowserCurlResponse,
   type BrowserCreateParams,
   type BrowserRetrieveParams,
   type BrowserUpdateParams,
   type BrowserListParams,
   type BrowserDeleteParams,
+  type BrowserCurlParams,
   type BrowserLoadExtensionsParams,
   type ProfilesOffsetPagination,
   type BrowserListResponsesOffsetPagination,

package/src/resources/browsers/replays.ts

@@ -143,7 +143,8 @@ export interface ReplayDownloadParams {
 
 export interface ReplayStartParams {
   /**
-   * Recording framerate in fps.
+   * Recording framerate in fps. Values above 20 require GPU to be enabled on the
+   * browser session.
    */
   framerate?: number;
 

package/src/resources/index.ts

@@ -29,11 +29,13 @@ export {
   type BrowserRetrieveResponse,
   type BrowserUpdateResponse,
   type BrowserListResponse,
+  type BrowserCurlResponse,
   type BrowserCreateParams,
   type BrowserRetrieveParams,
   type BrowserUpdateParams,
   type BrowserListParams,
   type BrowserDeleteParams,
+  type BrowserCurlParams,
   type BrowserLoadExtensionsParams,
   type ProfilesOffsetPagination,
   type BrowserListResponsesOffsetPagination,

package/src/resources/projects/projects.ts

@@ -16,8 +16,8 @@ export class Projects extends APIResource {
   limits: LimitsAPI.Limits = new LimitsAPI.Limits(this._client);
 
   /**
-   * Create a new project within the authenticated organization. Requires a paid plan
-   * and the projects feature flag.
+   * Create a new project within the authenticated organization. Requires the
+   * projects feature flag.
    *
    * @example
    * ```ts

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.48.0'; // x-release-please-version
+export const VERSION = '0.51.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.48.0";
+export declare const VERSION = "0.51.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.48.0";
+export declare const VERSION = "0.51.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.48.0'; // x-release-please-version
+exports.VERSION = '0.51.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.48.0'; // x-release-please-version
+export const VERSION = '0.51.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map