@onkernel/sdk 0.23.0 → 0.25.0

package/src/resources/browser-pools.ts

@@ -162,7 +162,7 @@ export interface BrowserPool {
   /**
    * Configuration used to create all browsers in this pool
    */
-  browser_pool_config: BrowserPoolRequest;
+  browser_pool_config: BrowserPool.BrowserPoolConfig;
 
   /**
    * Timestamp when the browser pool was created
@@ -175,118 +175,79 @@ export interface BrowserPool {
   name?: string;
 }
 
-/**
- * Request body for acquiring a browser from the pool.
- */
-export interface BrowserPoolAcquireRequest {
-  /**
-   * Maximum number of seconds to wait for a browser to be available. Defaults to the
-   * calculated time it would take to fill the pool at the currently configured fill
-   * rate.
-   */
-  acquire_timeout_seconds?: number;
-}
-
-/**
- * Request body for releasing a browser back to the pool.
- */
-export interface BrowserPoolReleaseRequest {
-  /**
-   * Browser session ID to release back to the pool
-   */
-  session_id: string;
-
-  /**
-   * Whether to reuse the browser instance or destroy it and create a new one.
-   * Defaults to true.
-   */
-  reuse?: boolean;
-}
-
-/**
- * Parameters for creating a browser pool. All browsers in the pool will be created
- * with the same configuration.
- */
-export interface BrowserPoolRequest {
-  /**
-   * Number of browsers to create in the pool
-   */
-  size: number;
-
-  /**
-   * List of browser extensions to load into the session. Provide each by id or name.
-   */
-  extensions?: Array<Shared.BrowserExtension>;
-
-  /**
-   * Percentage of the pool to fill per minute. Defaults to 10%.
-   */
-  fill_rate_per_minute?: number;
-
-  /**
-   * If true, launches the browser using a headless image. Defaults to false.
-   */
-  headless?: boolean;
-
-  /**
-   * If true, launches the browser in kiosk mode to hide address bar and tabs in live
-   * view.
-   */
-  kiosk_mode?: boolean;
-
-  /**
-   * Optional name for the browser pool. Must be unique within the organization.
-   */
-  name?: string;
-
-  /**
-   * Profile selection for the browser session. Provide either id or name. If
-   * specified, the matching profile will be loaded into the browser session.
-   * Profiles must be created beforehand.
-   */
-  profile?: Shared.BrowserProfile;
-
+export namespace BrowserPool {
   /**
-   * 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.
-   */
-  stealth?: boolean;
-
-  /**
-   * Default idle timeout in seconds for browsers acquired from this pool before they
-   * are destroyed. Defaults to 600 seconds if not specified
-   */
-  timeout_seconds?: number;
-
-  /**
-   * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (1920x1080@25). Only specific viewport configurations are
-   * supported. The server will reject unsupported combinations. Supported
-   * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
-   * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
-   * automatically determined from the width and height if they match a supported
-   * configuration exactly. Note: Higher resolutions may affect the responsiveness of
-   * live view browser
-   */
-  viewport?: Shared.BrowserViewport;
-}
-
-/**
- * Parameters for updating a browser pool. All browsers in the pool will be created
- * with the same configuration.
- */
-export interface BrowserPoolUpdateRequest extends BrowserPoolRequest {
-  /**
-   * Whether to discard all idle browsers and rebuild the pool immediately. Defaults
-   * to false.
+   * Configuration used to create all browsers in this pool
    */
-  discard_all_idle?: boolean;
+  export interface BrowserPoolConfig {
+    /**
+     * Number of browsers to create in the pool
+     */
+    size: number;
+
+    /**
+     * List of browser extensions to load into the session. Provide each by id or name.
+     */
+    extensions?: Array<Shared.BrowserExtension>;
+
+    /**
+     * Percentage of the pool to fill per minute. Defaults to 10%.
+     */
+    fill_rate_per_minute?: number;
+
+    /**
+     * If true, launches the browser using a headless image. Defaults to false.
+     */
+    headless?: boolean;
+
+    /**
+     * If true, launches the browser in kiosk mode to hide address bar and tabs in live
+     * view.
+     */
+    kiosk_mode?: boolean;
+
+    /**
+     * Optional name for the browser pool. Must be unique within the organization.
+     */
+    name?: string;
+
+    /**
+     * Profile selection for the browser session. Provide either id or name. If
+     * specified, the matching profile will be loaded into the browser session.
+     * Profiles must be created beforehand.
+     */
+    profile?: Shared.BrowserProfile;
+
+    /**
+     * 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.
+     */
+    stealth?: boolean;
+
+    /**
+     * Default idle timeout in seconds for browsers acquired from this pool before they
+     * are destroyed. Defaults to 600 seconds if not specified
+     */
+    timeout_seconds?: number;
+
+    /**
+     * Initial browser window size in pixels with optional refresh rate. If omitted,
+     * image defaults apply (1920x1080@25). Only specific viewport configurations are
+     * supported. The server will reject unsupported combinations. Supported
+     * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
+     * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
+     * automatically determined from the width and height if they match a supported
+     * configuration exactly. Note: Higher resolutions may affect the responsiveness of
+     * live view browser
+     */
+    viewport?: Shared.BrowserViewport;
+  }
 }
 
 export type BrowserPoolListResponse = Array<BrowserPool>;
@@ -546,10 +507,6 @@ export interface BrowserPoolReleaseParams {
 export declare namespace BrowserPools {
   export {
     type BrowserPool as BrowserPool,
-    type BrowserPoolAcquireRequest as BrowserPoolAcquireRequest,
-    type BrowserPoolReleaseRequest as BrowserPoolReleaseRequest,
-    type BrowserPoolRequest as BrowserPoolRequest,
-    type BrowserPoolUpdateRequest as BrowserPoolUpdateRequest,
     type BrowserPoolListResponse as BrowserPoolListResponse,
     type BrowserPoolAcquireResponse as BrowserPoolAcquireResponse,
     type BrowserPoolCreateParams as BrowserPoolCreateParams,

package/src/resources/credentials.ts

@@ -0,0 +1,314 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class Credentials extends APIResource {
+  /**
+   * Create a new credential for storing login information.
+   *
+   * @example
+   * ```ts
+   * const credential = await client.credentials.create({
+   *   domain: 'netflix.com',
+   *   name: 'my-netflix-login',
+   *   values: {
+   *     username: 'user@example.com',
+   *     password: 'mysecretpassword',
+   *   },
+   * });
+   * ```
+   */
+  create(body: CredentialCreateParams, options?: RequestOptions): APIPromise<Credential> {
+    return this._client.post('/credentials', { body, ...options });
+  }
+
+  /**
+   * Retrieve a credential by its ID or name. Credential values are not returned.
+   *
+   * @example
+   * ```ts
+   * const credential = await client.credentials.retrieve(
+   *   'id_or_name',
+   * );
+   * ```
+   */
+  retrieve(idOrName: string, options?: RequestOptions): APIPromise<Credential> {
+    return this._client.get(path`/credentials/${idOrName}`, options);
+  }
+
+  /**
+   * Update a credential's name or values. When values are provided, they are merged
+   * with existing values (new keys are added, existing keys are overwritten).
+   *
+   * @example
+   * ```ts
+   * const credential = await client.credentials.update(
+   *   'id_or_name',
+   * );
+   * ```
+   */
+  update(idOrName: string, body: CredentialUpdateParams, options?: RequestOptions): APIPromise<Credential> {
+    return this._client.patch(path`/credentials/${idOrName}`, { body, ...options });
+  }
+
+  /**
+   * List credentials owned by the caller's organization. Credential values are not
+   * returned.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const credential of client.credentials.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: CredentialListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<CredentialsOffsetPagination, Credential> {
+    return this._client.getAPIList('/credentials', OffsetPagination<Credential>, { query, ...options });
+  }
+
+  /**
+   * Delete a credential by its ID or name.
+   *
+   * @example
+   * ```ts
+   * await client.credentials.delete('id_or_name');
+   * ```
+   */
+  delete(idOrName: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/credentials/${idOrName}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Returns the current 6-digit TOTP code for a credential with a configured
+   * totp_secret. Use this to complete 2FA setup on sites or when you need a fresh
+   * code.
+   *
+   * @example
+   * ```ts
+   * const response = await client.credentials.totpCode(
+   *   'id_or_name',
+   * );
+   * ```
+   */
+  totpCode(idOrName: string, options?: RequestOptions): APIPromise<CredentialTotpCodeResponse> {
+    return this._client.get(path`/credentials/${idOrName}/totp-code`, options);
+  }
+}
+
+export type CredentialsOffsetPagination = OffsetPagination<Credential>;
+
+/**
+ * Request to create a new credential
+ */
+export interface CreateCredentialRequest {
+  /**
+   * Target domain this credential is for
+   */
+  domain: string;
+
+  /**
+   * Unique name for the credential within the organization
+   */
+  name: string;
+
+  /**
+   * Field name to value mapping (e.g., username, password)
+   */
+  values: { [key: string]: string };
+
+  /**
+   * If set, indicates this credential should be used with the specified SSO provider
+   * (e.g., google, github, microsoft). When the target site has a matching SSO
+   * button, it will be clicked first before filling credential values on the
+   * identity provider's login page.
+   */
+  sso_provider?: string;
+
+  /**
+   * Base32-encoded TOTP secret for generating one-time passwords. Used for automatic
+   * 2FA during login.
+   */
+  totp_secret?: string;
+}
+
+/**
+ * A stored credential for automatic re-authentication
+ */
+export interface Credential {
+  /**
+   * Unique identifier for the credential
+   */
+  id: string;
+
+  /**
+   * When the credential was created
+   */
+  created_at: string;
+
+  /**
+   * Target domain this credential is for
+   */
+  domain: string;
+
+  /**
+   * Unique name for the credential within the organization
+   */
+  name: string;
+
+  /**
+   * When the credential was last updated
+   */
+  updated_at: string;
+
+  /**
+   * Whether this credential has a TOTP secret configured for automatic 2FA
+   */
+  has_totp_secret?: boolean;
+
+  /**
+   * If set, indicates this credential should be used with the specified SSO provider
+   * (e.g., google, github, microsoft). When the target site has a matching SSO
+   * button, it will be clicked first before filling credential values on the
+   * identity provider's login page.
+   */
+  sso_provider?: string | null;
+
+  /**
+   * Current 6-digit TOTP code. Only included in create/update responses when
+   * totp_secret was just set.
+   */
+  totp_code?: string;
+
+  /**
+   * When the totp_code expires. Only included when totp_code is present.
+   */
+  totp_code_expires_at?: string;
+}
+
+/**
+ * Request to update an existing credential
+ */
+export interface UpdateCredentialRequest {
+  /**
+   * New name for the credential
+   */
+  name?: string;
+
+  /**
+   * If set, indicates this credential should be used with the specified SSO
+   * provider. Set to empty string or null to remove.
+   */
+  sso_provider?: string | null;
+
+  /**
+   * Base32-encoded TOTP secret for generating one-time passwords. Spaces and
+   * formatting are automatically normalized. Set to empty string to remove.
+   */
+  totp_secret?: string;
+
+  /**
+   * Field name to value mapping. Values are merged with existing values (new keys
+   * added, existing keys overwritten).
+   */
+  values?: { [key: string]: string };
+}
+
+export interface CredentialTotpCodeResponse {
+  /**
+   * Current 6-digit TOTP code
+   */
+  code: string;
+
+  /**
+   * When this code expires (ISO 8601 timestamp)
+   */
+  expires_at: string;
+}
+
+export interface CredentialCreateParams {
+  /**
+   * Target domain this credential is for
+   */
+  domain: string;
+
+  /**
+   * Unique name for the credential within the organization
+   */
+  name: string;
+
+  /**
+   * Field name to value mapping (e.g., username, password)
+   */
+  values: { [key: string]: string };
+
+  /**
+   * If set, indicates this credential should be used with the specified SSO provider
+   * (e.g., google, github, microsoft). When the target site has a matching SSO
+   * button, it will be clicked first before filling credential values on the
+   * identity provider's login page.
+   */
+  sso_provider?: string;
+
+  /**
+   * Base32-encoded TOTP secret for generating one-time passwords. Used for automatic
+   * 2FA during login.
+   */
+  totp_secret?: string;
+}
+
+export interface CredentialUpdateParams {
+  /**
+   * New name for the credential
+   */
+  name?: string;
+
+  /**
+   * If set, indicates this credential should be used with the specified SSO
+   * provider. Set to empty string or null to remove.
+   */
+  sso_provider?: string | null;
+
+  /**
+   * Base32-encoded TOTP secret for generating one-time passwords. Spaces and
+   * formatting are automatically normalized. Set to empty string to remove.
+   */
+  totp_secret?: string;
+
+  /**
+   * Field name to value mapping. Values are merged with existing values (new keys
+   * added, existing keys overwritten).
+   */
+  values?: { [key: string]: string };
+}
+
+export interface CredentialListParams extends OffsetPaginationParams {
+  /**
+   * Filter by domain
+   */
+  domain?: string;
+}
+
+export declare namespace Credentials {
+  export {
+    type CreateCredentialRequest as CreateCredentialRequest,
+    type Credential as Credential,
+    type UpdateCredentialRequest as UpdateCredentialRequest,
+    type CredentialTotpCodeResponse as CredentialTotpCodeResponse,
+    type CredentialsOffsetPagination as CredentialsOffsetPagination,
+    type CredentialCreateParams as CredentialCreateParams,
+    type CredentialUpdateParams as CredentialUpdateParams,
+    type CredentialListParams as CredentialListParams,
+  };
+}

package/src/resources/index.ts

@@ -11,10 +11,6 @@ export {
 export {
   BrowserPools,
   type BrowserPool,
-  type BrowserPoolAcquireRequest,
-  type BrowserPoolReleaseRequest,
-  type BrowserPoolRequest,
-  type BrowserPoolUpdateRequest,
   type BrowserPoolListResponse,
   type BrowserPoolAcquireResponse,
   type BrowserPoolCreateParams,
@@ -36,6 +32,17 @@ export {
   type BrowserLoadExtensionsParams,
   type BrowserListResponsesOffsetPagination,
 } from './browsers/browsers';
+export {
+  Credentials,
+  type CreateCredentialRequest,
+  type Credential,
+  type UpdateCredentialRequest,
+  type CredentialTotpCodeResponse,
+  type CredentialCreateParams,
+  type CredentialUpdateParams,
+  type CredentialListParams,
+  type CredentialsOffsetPagination,
+} from './credentials';
 export {
   Deployments,
   type DeploymentStateEvent,
@@ -75,5 +82,6 @@ export {
   type ProxyCreateResponse,
   type ProxyRetrieveResponse,
   type ProxyListResponse,
+  type ProxyCheckResponse,
   type ProxyCreateParams,
 } from './proxies';