@onkernel/sdk 0.25.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/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,

package/src/resources/proxies.ts

@@ -68,6 +68,11 @@ export interface ProxyCreateResponse {
     | ProxyCreateResponse.MobileProxyConfig
     | ProxyCreateResponse.CustomProxyConfig;
 
+  /**
+   * IP address that the proxy uses when making requests.
+   */
+  ip_address?: string;
+
   /**
    * Timestamp of the last health check performed on this proxy.
    */
@@ -288,6 +293,11 @@ export interface ProxyRetrieveResponse {
     | ProxyRetrieveResponse.MobileProxyConfig
     | ProxyRetrieveResponse.CustomProxyConfig;
 
+  /**
+   * IP address that the proxy uses when making requests.
+   */
+  ip_address?: string;
+
   /**
    * Timestamp of the last health check performed on this proxy.
    */
@@ -511,6 +521,11 @@ export namespace ProxyListResponse {
       | ProxyListResponseItem.MobileProxyConfig
       | ProxyListResponseItem.CustomProxyConfig;
 
+    /**
+     * IP address that the proxy uses when making requests.
+     */
+    ip_address?: string;
+
     /**
      * Timestamp of the last health check performed on this proxy.
      */
@@ -732,6 +747,11 @@ export interface ProxyCheckResponse {
     | ProxyCheckResponse.MobileProxyConfig
     | ProxyCheckResponse.CustomProxyConfig;
 
+  /**
+   * IP address that the proxy uses when making requests.
+   */
+  ip_address?: string;
+
   /**
    * Timestamp of the last health check performed on this proxy.
    */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.25.0'; // x-release-please-version
+export const VERSION = '0.26.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.25.0";
+export declare const VERSION = "0.26.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.25.0'; // x-release-please-version
+exports.VERSION = '0.26.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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