@onkernel/sdk 0.24.0 → 0.26.0

package/src/resources/browsers/browsers.ts

@@ -26,6 +26,8 @@ import {
   ProcessExecResponse,
   ProcessKillParams,
   ProcessKillResponse,
+  ProcessResizeParams,
+  ProcessResizeResponse,
   ProcessSpawnParams,
   ProcessSpawnResponse,
   ProcessStatusParams,
@@ -107,6 +109,20 @@ export class Browsers extends APIResource {
     return this._client.get(path`/browsers/${id}`, options);
   }
 
+  /**
+   * Update a browser session.
+   *
+   * @example
+   * ```ts
+   * const browser = await client.browsers.update(
+   *   'htzv5orfit78e1m2biiifpbv',
+   * );
+   * ```
+   */
+  update(id: string, body: BrowserUpdateParams, options?: RequestOptions): APIPromise<BrowserUpdateResponse> {
+    return this._client.patch(path`/browsers/${id}`, { body, ...options });
+  }
+
   /**
    * List all browser sessions with pagination support. Use include_deleted=true to
    * include soft-deleted sessions in the results.
@@ -380,6 +396,82 @@ export interface BrowserRetrieveResponse {
   viewport?: Shared.BrowserViewport;
 }
 
+export interface BrowserUpdateResponse {
+  /**
+   * Websocket URL for Chrome DevTools Protocol connections to the browser session
+   */
+  cdp_ws_url: string;
+
+  /**
+   * When the browser session was created.
+   */
+  created_at: string;
+
+  /**
+   * Whether the browser session is running in headless mode.
+   */
+  headless: boolean;
+
+  /**
+   * Unique identifier for the browser session
+   */
+  session_id: string;
+
+  /**
+   * Whether the browser session is running in stealth mode.
+   */
+  stealth: boolean;
+
+  /**
+   * The number of seconds of inactivity before the browser session is terminated.
+   */
+  timeout_seconds: number;
+
+  /**
+   * Remote URL for live viewing the browser session. Only available for non-headless
+   * browsers.
+   */
+  browser_live_view_url?: string;
+
+  /**
+   * When the browser session was soft-deleted. Only present for deleted sessions.
+   */
+  deleted_at?: string;
+
+  /**
+   * Whether the browser session is running in kiosk mode.
+   */
+  kiosk_mode?: boolean;
+
+  /**
+   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
+   * instead.
+   */
+  persistence?: BrowserPersistence;
+
+  /**
+   * Browser profile metadata.
+   */
+  profile?: Profile;
+
+  /**
+   * ID of the proxy associated with this browser session, if any.
+   */
+  proxy_id?: string;
+
+  /**
+   * 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 interface BrowserListResponse {
   /**
    * Websocket URL for Chrome DevTools Protocol connections to the browser session
@@ -526,6 +618,14 @@ export interface BrowserCreateParams {
   viewport?: Shared.BrowserViewport;
 }
 
+export interface BrowserUpdateParams {
+  /**
+   * ID of the proxy to use. Omit to leave unchanged, set to empty string to remove
+   * proxy.
+   */
+  proxy_id?: string | null;
+}
+
 export interface BrowserListParams extends OffsetPaginationParams {
   /**
    * When true, includes soft-deleted browser sessions in the results alongside
@@ -576,9 +676,11 @@ export declare namespace Browsers {
     type Profile as Profile,
     type BrowserCreateResponse as BrowserCreateResponse,
     type BrowserRetrieveResponse as BrowserRetrieveResponse,
+    type BrowserUpdateResponse as BrowserUpdateResponse,
     type BrowserListResponse as BrowserListResponse,
     type BrowserListResponsesOffsetPagination as BrowserListResponsesOffsetPagination,
     type BrowserCreateParams as BrowserCreateParams,
+    type BrowserUpdateParams as BrowserUpdateParams,
     type BrowserListParams as BrowserListParams,
     type BrowserDeleteParams as BrowserDeleteParams,
     type BrowserLoadExtensionsParams as BrowserLoadExtensionsParams,
@@ -615,12 +717,14 @@ export declare namespace Browsers {
     Process as Process,
     type ProcessExecResponse as ProcessExecResponse,
     type ProcessKillResponse as ProcessKillResponse,
+    type ProcessResizeResponse as ProcessResizeResponse,
     type ProcessSpawnResponse as ProcessSpawnResponse,
     type ProcessStatusResponse as ProcessStatusResponse,
     type ProcessStdinResponse as ProcessStdinResponse,
     type ProcessStdoutStreamResponse as ProcessStdoutStreamResponse,
     type ProcessExecParams as ProcessExecParams,
     type ProcessKillParams as ProcessKillParams,
+    type ProcessResizeParams as ProcessResizeParams,
     type ProcessSpawnParams as ProcessSpawnParams,
     type ProcessStatusParams as ProcessStatusParams,
     type ProcessStdinParams as ProcessStdinParams,

package/src/resources/browsers/index.ts

@@ -6,8 +6,10 @@ export {
   type Profile,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,
+  type BrowserUpdateResponse,
   type BrowserListResponse,
   type BrowserCreateParams,
+  type BrowserUpdateParams,
   type BrowserListParams,
   type BrowserDeleteParams,
   type BrowserLoadExtensionsParams,
@@ -48,12 +50,14 @@ export {
   Process,
   type ProcessExecResponse,
   type ProcessKillResponse,
+  type ProcessResizeResponse,
   type ProcessSpawnResponse,
   type ProcessStatusResponse,
   type ProcessStdinResponse,
   type ProcessStdoutStreamResponse,
   type ProcessExecParams,
   type ProcessKillParams,
+  type ProcessResizeParams,
   type ProcessSpawnParams,
   type ProcessStatusParams,
   type ProcessStdinParams,

package/src/resources/browsers/process.ts

@@ -42,6 +42,30 @@ export class Process extends APIResource {
     return this._client.post(path`/browsers/${id}/process/${processID}/kill`, { body, ...options });
   }
 
+  /**
+   * Resize a PTY-backed process terminal
+   *
+   * @example
+   * ```ts
+   * const response = await client.browsers.process.resize(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *   {
+   *     id: 'id',
+   *     cols: 1,
+   *     rows: 1,
+   *   },
+   * );
+   * ```
+   */
+  resize(
+    processID: string,
+    params: ProcessResizeParams,
+    options?: RequestOptions,
+  ): APIPromise<ProcessResizeResponse> {
+    const { id, ...body } = params;
+    return this._client.post(path`/browsers/${id}/process/${processID}/resize`, { body, ...options });
+  }
+
   /**
    * Execute a command asynchronously
    *
@@ -156,6 +180,16 @@ export interface ProcessKillResponse {
   ok: boolean;
 }
 
+/**
+ * Generic OK response.
+ */
+export interface ProcessResizeResponse {
+  /**
+   * Indicates success.
+   */
+  ok: boolean;
+}
+
 /**
  * Information about a spawned process.
  */
@@ -285,12 +319,34 @@ export interface ProcessKillParams {
   signal: 'TERM' | 'KILL' | 'INT' | 'HUP';
 }
 
+export interface ProcessResizeParams {
+  /**
+   * Path param: Browser session ID
+   */
+  id: string;
+
+  /**
+   * Body param: New terminal columns.
+   */
+  cols: number;
+
+  /**
+   * Body param: New terminal rows.
+   */
+  rows: number;
+}
+
 export interface ProcessSpawnParams {
   /**
    * Executable or shell command to run.
    */
   command: string;
 
+  /**
+   * Allocate a pseudo-terminal (PTY) for interactive shells.
+   */
+  allocate_tty?: boolean;
+
   /**
    * Command arguments.
    */
@@ -306,6 +362,11 @@ export interface ProcessSpawnParams {
    */
   as_user?: string | null;
 
+  /**
+   * Initial terminal columns. Only used when allocate_tty is true.
+   */
+  cols?: number;
+
   /**
    * Working directory (absolute path) to run the command in.
    */
@@ -316,6 +377,11 @@ export interface ProcessSpawnParams {
    */
   env?: { [key: string]: string };
 
+  /**
+   * Initial terminal rows. Only used when allocate_tty is true.
+   */
+  rows?: number;
+
   /**
    * Maximum execution time in seconds.
    */
@@ -352,12 +418,14 @@ export declare namespace Process {
   export {
     type ProcessExecResponse as ProcessExecResponse,
     type ProcessKillResponse as ProcessKillResponse,
+    type ProcessResizeResponse as ProcessResizeResponse,
     type ProcessSpawnResponse as ProcessSpawnResponse,
     type ProcessStatusResponse as ProcessStatusResponse,
     type ProcessStdinResponse as ProcessStdinResponse,
     type ProcessStdoutStreamResponse as ProcessStdoutStreamResponse,
     type ProcessExecParams as ProcessExecParams,
     type ProcessKillParams as ProcessKillParams,
+    type ProcessResizeParams as ProcessResizeParams,
     type ProcessSpawnParams as ProcessSpawnParams,
     type ProcessStatusParams as ProcessStatusParams,
     type ProcessStdinParams as ProcessStdinParams,

package/src/resources/credentials.ts

@@ -9,8 +9,7 @@ import { path } from '../internal/utils/path';
 
 export class Credentials extends APIResource {
   /**
-   * Create a new credential for storing login information. Values are encrypted at
-   * rest.
+   * Create a new credential for storing login information.
    *
    * @example
    * ```ts
@@ -29,27 +28,32 @@ export class Credentials extends APIResource {
   }
 
   /**
-   * Retrieve a credential by its ID. Credential values are not returned.
+   * Retrieve a credential by its ID or name. Credential values are not returned.
    *
    * @example
    * ```ts
-   * const credential = await client.credentials.retrieve('id');
+   * const credential = await client.credentials.retrieve(
+   *   'id_or_name',
+   * );
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<Credential> {
-    return this._client.get(path`/credentials/${id}`, options);
+  retrieve(idOrName: string, options?: RequestOptions): APIPromise<Credential> {
+    return this._client.get(path`/credentials/${idOrName}`, options);
   }
 
   /**
-   * Update a credential's name or values. Values are encrypted at rest.
+   * 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');
+   * const credential = await client.credentials.update(
+   *   'id_or_name',
+   * );
    * ```
    */
-  update(id: string, body: CredentialUpdateParams, options?: RequestOptions): APIPromise<Credential> {
-    return this._client.patch(path`/credentials/${id}`, { body, ...options });
+  update(idOrName: string, body: CredentialUpdateParams, options?: RequestOptions): APIPromise<Credential> {
+    return this._client.patch(path`/credentials/${idOrName}`, { body, ...options });
   }
 
   /**
@@ -72,19 +76,35 @@ export class Credentials extends APIResource {
   }
 
   /**
-   * Delete a credential by its ID.
+   * Delete a credential by its ID or name.
    *
    * @example
    * ```ts
-   * await client.credentials.delete('id');
+   * await client.credentials.delete('id_or_name');
    * ```
    */
-  delete(id: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.delete(path`/credentials/${id}`, {
+  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>;
@@ -107,6 +127,20 @@ export interface CreateCredentialRequest {
    * 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;
 }
 
 /**
@@ -137,6 +171,30 @@ export interface Credential {
    * 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;
 }
 
 /**
@@ -149,12 +207,36 @@ export interface UpdateCredentialRequest {
   name?: string;
 
   /**
-   * Field name to value mapping (e.g., username, password). Replaces all existing
-   * values.
+   * 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
@@ -170,6 +252,20 @@ export interface CredentialCreateParams {
    * 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 {
@@ -179,8 +275,20 @@ export interface CredentialUpdateParams {
   name?: string;
 
   /**
-   * Field name to value mapping (e.g., username, password). Replaces all existing
-   * values.
+   * 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 };
 }
@@ -197,6 +305,7 @@ export declare namespace Credentials {
     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,

package/src/resources/index.ts

@@ -25,8 +25,10 @@ export {
   type Profile,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,
+  type BrowserUpdateResponse,
   type BrowserListResponse,
   type BrowserCreateParams,
+  type BrowserUpdateParams,
   type BrowserListParams,
   type BrowserDeleteParams,
   type BrowserLoadExtensionsParams,
@@ -37,6 +39,7 @@ export {
   type CreateCredentialRequest,
   type Credential,
   type UpdateCredentialRequest,
+  type CredentialTotpCodeResponse,
   type CredentialCreateParams,
   type CredentialUpdateParams,
   type CredentialListParams,
@@ -81,5 +84,6 @@ export {
   type ProxyCreateResponse,
   type ProxyRetrieveResponse,
   type ProxyListResponse,
+  type ProxyCheckResponse,
   type ProxyCreateParams,
 } from './proxies';