@onkernel/sdk 0.51.0 → 0.53.0

package/src/resources/browser-pools.ts

@@ -220,7 +220,7 @@ export namespace BrowserPool {
     kiosk_mode?: boolean;
 
     /**
-     * Optional name for the browser pool. Must be unique within the organization.
+     * Optional name for the browser pool. Must be unique within the project.
      */
     name?: string;
 
@@ -237,6 +237,15 @@ export namespace BrowserPool {
      */
     proxy_id?: string;
 
+    /**
+     * Optional URL to navigate to when a new browser is warmed into the pool.
+     * Best-effort: failures to navigate do not fail pool fill. Only applied to
+     * newly-warmed browsers — browsers reused via release/acquire keep whatever URL
+     * the previous lease left them on. Accepts any URL Chromium can resolve, including
+     * chrome:// pages.
+     */
+    start_url?: string;
+
     /**
      * If true, launches the browser in stealth mode to reduce detection by anti-bot
      * mechanisms.
@@ -353,6 +362,12 @@ export interface BrowserPoolAcquireResponse {
    */
   proxy_id?: string;
 
+  /**
+   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * debugging — navigation is best-effort and may have failed.
+   */
+  start_url?: string;
+
   /**
    * Session usage metrics.
    */
@@ -413,7 +428,7 @@ export interface BrowserPoolCreateParams {
   kiosk_mode?: boolean;
 
   /**
-   * Optional name for the browser pool. Must be unique within the organization.
+   * Optional name for the browser pool. Must be unique within the project.
    */
   name?: string;
 
@@ -430,6 +445,15 @@ export interface BrowserPoolCreateParams {
    */
   proxy_id?: string;
 
+  /**
+   * Optional URL to navigate to when a new browser is warmed into the pool.
+   * Best-effort: failures to navigate do not fail pool fill. Only applied to
+   * newly-warmed browsers — browsers reused via release/acquire keep whatever URL
+   * the previous lease left them on. Accepts any URL Chromium can resolve, including
+   * chrome:// pages.
+   */
+  start_url?: string;
+
   /**
    * If true, launches the browser in stealth mode to reduce detection by anti-bot
    * mechanisms.
@@ -503,7 +527,7 @@ export interface BrowserPoolUpdateParams {
   kiosk_mode?: boolean;
 
   /**
-   * Optional name for the browser pool. Must be unique within the organization.
+   * Optional name for the browser pool. Must be unique within the project.
    */
   name?: string;
 
@@ -520,6 +544,15 @@ export interface BrowserPoolUpdateParams {
    */
   proxy_id?: string;
 
+  /**
+   * Optional URL to navigate to when a new browser is warmed into the pool.
+   * Best-effort: failures to navigate do not fail pool fill. Only applied to
+   * newly-warmed browsers — browsers reused via release/acquire keep whatever URL
+   * the previous lease left them on. Accepts any URL Chromium can resolve, including
+   * chrome:// pages.
+   */
+  start_url?: string;
+
   /**
    * If true, launches the browser in stealth mode to reduce detection by anti-bot
    * mechanisms.

package/src/resources/browsers/browsers.ts

@@ -392,6 +392,12 @@ export interface BrowserCreateResponse {
    */
   proxy_id?: string;
 
+  /**
+   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * debugging — navigation is best-effort and may have failed.
+   */
+  start_url?: string;
+
   /**
    * Session usage metrics.
    */
@@ -498,6 +504,12 @@ export interface BrowserRetrieveResponse {
    */
   proxy_id?: string;
 
+  /**
+   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * debugging — navigation is best-effort and may have failed.
+   */
+  start_url?: string;
+
   /**
    * Session usage metrics.
    */
@@ -604,6 +616,12 @@ export interface BrowserUpdateResponse {
    */
   proxy_id?: string;
 
+  /**
+   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * debugging — navigation is best-effort and may have failed.
+   */
+  start_url?: string;
+
   /**
    * Session usage metrics.
    */
@@ -710,6 +728,12 @@ export interface BrowserListResponse {
    */
   proxy_id?: string;
 
+  /**
+   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * debugging — navigation is best-effort and may have failed.
+   */
+  start_url?: string;
+
   /**
    * Session usage metrics.
    */
@@ -805,6 +829,15 @@ export interface BrowserCreateParams {
    */
   proxy_id?: string;
 
+  /**
+   * Optional URL to navigate to immediately after the browser is created.
+   * Best-effort: failures to navigate do not fail browser creation. Any pre-existing
+   * tabs are reduced to a single tab which is then navigated. Accepts any URL
+   * Chromium can resolve, including chrome:// pages. Ignored when reusing an
+   * existing persistent session.
+   */
+  start_url?: string;
+
   /**
    * If true, launches the browser in stealth mode to reduce detection by anti-bot
    * mechanisms.

package/src/resources/credentials.ts

@@ -122,7 +122,7 @@ export interface CreateCredentialRequest {
   domain: string;
 
   /**
-   * Unique name for the credential within the organization
+   * Unique name for the credential within the project
    */
   name: string;
 
@@ -166,7 +166,7 @@ export interface Credential {
   domain: string;
 
   /**
-   * Unique name for the credential within the organization
+   * Unique name for the credential within the project
    */
   name: string;
 
@@ -252,7 +252,7 @@ export interface CredentialCreateParams {
   domain: string;
 
   /**
-   * Unique name for the credential within the organization
+   * Unique name for the credential within the project
    */
   name: string;
 

package/src/resources/extensions.ts

@@ -132,7 +132,7 @@ export namespace ExtensionListResponse {
 
     /**
      * Optional, easier-to-reference name for the extension. Must be unique within the
-     * organization.
+     * project.
      */
     name?: string | null;
   }
@@ -164,7 +164,7 @@ export interface ExtensionUploadResponse {
 
   /**
    * Optional, easier-to-reference name for the extension. Must be unique within the
-   * organization.
+   * project.
    */
   name?: string | null;
 }
@@ -188,7 +188,7 @@ export interface ExtensionUploadParams {
   file: Uploadable;
 
   /**
-   * Optional unique name within the organization to reference this extension.
+   * Optional unique name within the project to reference this extension.
    */
   name?: string;
 }

package/src/resources/invocations.ts

@@ -501,6 +501,12 @@ export namespace InvocationListBrowsersResponse {
      */
     proxy_id?: string;
 
+    /**
+     * URL the session was asked to navigate to on creation, if any. Recorded for
+     * debugging — navigation is best-effort and may have failed.
+     */
+    start_url?: string;
+
     /**
      * Session usage metrics.
      */

package/src/resources/profiles.ts

@@ -49,8 +49,7 @@ export class Profiles extends APIResource {
   }
 
   /**
-   * Download the profile. Profiles are JSON files containing the pieces of state
-   * that we save.
+   * Returns a zstd-compressed tar file of the full user-data directory.
    */
   download(idOrName: string, options?: RequestOptions): APIPromise<Response> {
     return this._client.get(path`/profiles/${idOrName}/download`, {
@@ -63,7 +62,7 @@ export class Profiles extends APIResource {
 
 export interface ProfileCreateParams {
   /**
-   * Optional name of the profile. Must be unique within the organization.
+   * Optional name of the profile. Must be unique within the project.
    */
   name?: string;
 }

package/src/resources/projects/projects.ts

@@ -155,7 +155,12 @@ export interface ProjectUpdateParams {
   status?: 'active' | 'archived';
 }
 
-export interface ProjectListParams extends OffsetPaginationParams {}
+export interface ProjectListParams extends OffsetPaginationParams {
+  /**
+   * Case-insensitive substring match against project name
+   */
+  query?: string;
+}
 
 Projects.Limits = Limits;
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.51.0'; // x-release-please-version
+export const VERSION = '0.53.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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