@onkernel/sdk 0.10.0 → 0.11.0

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/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,
@@ -32,3 +33,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.0'; // 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.0";
 //# 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.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.10.0'; // x-release-please-version
+exports.VERSION = '0.11.0'; // 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.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map