@onkernel/sdk 0.10.0 → 0.11.1

package/src/resources/browsers/browsers.ts

@@ -146,6 +146,36 @@ export interface BrowserPersistence {
   id: string;
 }
 
+/**
+ * Browser profile metadata.
+ */
+export interface Profile {
+  /**
+   * Unique identifier for the profile
+   */
+  id: string;
+
+  /**
+   * Timestamp when the profile was created
+   */
+  created_at: string;
+
+  /**
+   * Timestamp when the profile was last used
+   */
+  last_used_at?: string;
+
+  /**
+   * Optional, easier-to-reference name for the profile
+   */
+  name?: string | null;
+
+  /**
+   * Timestamp when the profile was last updated
+   */
+  updated_at?: string;
+}
+
 export interface BrowserCreateResponse {
   /**
    * Websocket URL for Chrome DevTools Protocol connections to the browser session
@@ -187,6 +217,11 @@ export interface BrowserCreateResponse {
    * Optional persistence configuration for the browser session.
    */
   persistence?: BrowserPersistence;
+
+  /**
+   * Browser profile metadata.
+   */
+  profile?: Profile;
 }
 
 export interface BrowserRetrieveResponse {
@@ -230,6 +265,11 @@ export interface BrowserRetrieveResponse {
    * Optional persistence configuration for the browser session.
    */
   persistence?: BrowserPersistence;
+
+  /**
+   * Browser profile metadata.
+   */
+  profile?: Profile;
 }
 
 export type BrowserListResponse = Array<BrowserListResponse.BrowserListResponseItem>;
@@ -276,6 +316,11 @@ export namespace BrowserListResponse {
      * Optional persistence configuration for the browser session.
      */
     persistence?: BrowsersAPI.BrowserPersistence;
+
+    /**
+     * Browser profile metadata.
+     */
+    profile?: BrowsersAPI.Profile;
   }
 }
 
@@ -296,6 +341,13 @@ export interface BrowserCreateParams {
    */
   persistence?: BrowserPersistence;
 
+  /**
+   * 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?: BrowserCreateParams.Profile;
+
   /**
    * If true, launches the browser in stealth mode to reduce detection by anti-bot
    * mechanisms.
@@ -310,6 +362,32 @@ export interface BrowserCreateParams {
   timeout_seconds?: number;
 }
 
+export namespace BrowserCreateParams {
+  /**
+   * 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.
+   */
+  export interface Profile {
+    /**
+     * Profile ID to load for this browser session
+     */
+    id?: string;
+
+    /**
+     * Profile name to load for this browser session (instead of id). Must be 1-255
+     * characters, using letters, numbers, dots, underscores, or hyphens.
+     */
+    name?: string;
+
+    /**
+     * If true, save changes made during the session back to the profile when the
+     * session ends.
+     */
+    save_changes?: boolean;
+  }
+}
+
 export interface BrowserDeleteParams {
   /**
    * Persistent browser identifier
@@ -325,6 +403,7 @@ Browsers.Logs = Logs;
 export declare namespace Browsers {
   export {
     type BrowserPersistence as BrowserPersistence,
+    type Profile as Profile,
     type BrowserCreateResponse as BrowserCreateResponse,
     type BrowserRetrieveResponse as BrowserRetrieveResponse,
     type BrowserListResponse as BrowserListResponse,

package/src/resources/browsers/index.ts

@@ -3,6 +3,7 @@
 export {
   Browsers,
   type BrowserPersistence,
+  type Profile,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,
   type BrowserListResponse,

package/src/resources/deployments.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../core/resource';
 import * as Shared from './shared';
 import { APIPromise } from '../core/api-promise';
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../core/pagination';
 import { Stream } from '../core/streaming';
 import { type Uploadable } from '../core/uploads';
 import { buildHeaders } from '../internal/headers';
@@ -43,14 +44,20 @@ export class Deployments extends APIResource {
    *
    * @example
    * ```ts
-   * const deployments = await client.deployments.list();
+   * // Automatically fetches more pages as needed.
+   * for await (const deploymentListResponse of client.deployments.list()) {
+   *   // ...
+   * }
    * ```
    */
   list(
     query: DeploymentListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<DeploymentListResponse> {
-    return this._client.get('/deployments', { query, ...options });
+  ): PagePromise<DeploymentListResponsesOffsetPagination, DeploymentListResponse> {
+    return this._client.getAPIList('/deployments', OffsetPagination<DeploymentListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -77,6 +84,8 @@ export class Deployments extends APIResource {
   }
 }
 
+export type DeploymentListResponsesOffsetPagination = OffsetPagination<DeploymentListResponse>;
+
 /**
  * An event representing the current state of a deployment.
  */
@@ -234,53 +243,49 @@ export interface DeploymentRetrieveResponse {
   updated_at?: string | null;
 }
 
-export type DeploymentListResponse = Array<DeploymentListResponse.DeploymentListResponseItem>;
-
-export namespace DeploymentListResponse {
+/**
+ * Deployment record information.
+ */
+export interface DeploymentListResponse {
   /**
-   * Deployment record information.
+   * Unique identifier for the deployment
    */
-  export interface DeploymentListResponseItem {
-    /**
-     * Unique identifier for the deployment
-     */
-    id: string;
+  id: string;
 
-    /**
-     * Timestamp when the deployment was created
-     */
-    created_at: string;
+  /**
+   * Timestamp when the deployment was created
+   */
+  created_at: string;
 
-    /**
-     * Deployment region code
-     */
-    region: 'aws.us-east-1a';
+  /**
+   * Deployment region code
+   */
+  region: 'aws.us-east-1a';
 
-    /**
-     * Current status of the deployment
-     */
-    status: 'queued' | 'in_progress' | 'running' | 'failed' | 'stopped';
+  /**
+   * Current status of the deployment
+   */
+  status: 'queued' | 'in_progress' | 'running' | 'failed' | 'stopped';
 
-    /**
-     * Relative path to the application entrypoint
-     */
-    entrypoint_rel_path?: string;
+  /**
+   * Relative path to the application entrypoint
+   */
+  entrypoint_rel_path?: string;
 
-    /**
-     * Environment variables configured for this deployment
-     */
-    env_vars?: { [key: string]: string };
+  /**
+   * Environment variables configured for this deployment
+   */
+  env_vars?: { [key: string]: string };
 
-    /**
-     * Status reason
-     */
-    status_reason?: string;
+  /**
+   * Status reason
+   */
+  status_reason?: string;
 
-    /**
-     * Timestamp when the deployment was last updated
-     */
-    updated_at?: string | null;
-  }
+  /**
+   * Timestamp when the deployment was last updated
+   */
+  updated_at?: string | null;
 }
 
 /**
@@ -373,7 +378,7 @@ export interface DeploymentCreateParams {
   version?: string;
 }
 
-export interface DeploymentListParams {
+export interface DeploymentListParams extends OffsetPaginationParams {
   /**
    * Filter results by application name.
    */
@@ -394,6 +399,7 @@ export declare namespace Deployments {
     type DeploymentRetrieveResponse as DeploymentRetrieveResponse,
     type DeploymentListResponse as DeploymentListResponse,
     type DeploymentFollowResponse as DeploymentFollowResponse,
+    type DeploymentListResponsesOffsetPagination as DeploymentListResponsesOffsetPagination,
     type DeploymentCreateParams as DeploymentCreateParams,
     type DeploymentListParams as DeploymentListParams,
     type DeploymentFollowParams as DeploymentFollowParams,

package/src/resources/index.ts

@@ -5,6 +5,7 @@ export { Apps, type AppListResponse, type AppListParams } from './apps';
 export {
   Browsers,
   type BrowserPersistence,
+  type Profile,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,
   type BrowserListResponse,
@@ -21,6 +22,7 @@ export {
   type DeploymentCreateParams,
   type DeploymentListParams,
   type DeploymentFollowParams,
+  type DeploymentListResponsesOffsetPagination,
 } from './deployments';
 export {
   Invocations,
@@ -32,3 +34,4 @@ export {
   type InvocationCreateParams,
   type InvocationUpdateParams,
 } from './invocations';
+export { Profiles, type ProfileListResponse, type ProfileCreateParams } from './profiles';

package/src/resources/profiles.ts

@@ -0,0 +1,67 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as BrowsersAPI from './browsers/browsers';
+import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class Profiles extends APIResource {
+  /**
+   * Create a browser profile that can be used to load state into future browser
+   * sessions.
+   */
+  create(body: ProfileCreateParams, options?: RequestOptions): APIPromise<BrowsersAPI.Profile> {
+    return this._client.post('/profiles', { body, ...options });
+  }
+
+  /**
+   * Retrieve details for a single profile by its ID or name.
+   */
+  retrieve(idOrName: string, options?: RequestOptions): APIPromise<BrowsersAPI.Profile> {
+    return this._client.get(path`/profiles/${idOrName}`, options);
+  }
+
+  /**
+   * List profiles with optional filtering and pagination.
+   */
+  list(options?: RequestOptions): APIPromise<ProfileListResponse> {
+    return this._client.get('/profiles', options);
+  }
+
+  /**
+   * Delete a profile by its ID or by its name.
+   */
+  delete(idOrName: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/profiles/${idOrName}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Download the profile. Profiles are JSON files containing the pieces of state
+   * that we save.
+   */
+  download(idOrName: string, options?: RequestOptions): APIPromise<Response> {
+    return this._client.get(path`/profiles/${idOrName}/download`, {
+      ...options,
+      headers: buildHeaders([{ Accept: 'application/octet-stream' }, options?.headers]),
+      __binaryResponse: true,
+    });
+  }
+}
+
+export type ProfileListResponse = Array<BrowsersAPI.Profile>;
+
+export interface ProfileCreateParams {
+  /**
+   * Optional name of the profile. Must be unique within the organization.
+   */
+  name?: string;
+}
+
+export declare namespace Profiles {
+  export { type ProfileListResponse as ProfileListResponse, type ProfileCreateParams as ProfileCreateParams };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.10.0'; // x-release-please-version
+export const VERSION = '0.11.1'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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