@onkernel/sdk 0.47.0 → 0.49.0

package/resources/projects.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.mjs","sourceRoot":"","sources":["../src/resources/projects.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/src/client.ts

@@ -118,6 +118,16 @@ import {
   Browsers,
   Profile,
 } from './resources/browsers/browsers';
+import {
+  CreateProjectRequest,
+  Project,
+  ProjectCreateParams,
+  ProjectListParams,
+  ProjectUpdateParams,
+  Projects,
+  ProjectsOffsetPagination,
+  UpdateProjectRequest,
+} from './resources/projects/projects';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -925,6 +935,10 @@ export class Kernel {
    * Create and manage credentials for authentication.
    */
   credentials: API.Credentials = new API.Credentials(this);
+  /**
+   * Create and manage projects for resource isolation within an organization.
+   */
+  projects: API.Projects = new API.Projects(this);
   /**
    * Configure external credential providers like 1Password.
    */
@@ -941,6 +955,7 @@ Kernel.Proxies = Proxies;
 Kernel.Extensions = Extensions;
 Kernel.BrowserPools = BrowserPools;
 Kernel.Credentials = Credentials;
+Kernel.Projects = Projects;
 Kernel.CredentialProviders = CredentialProviders;
 
 export declare namespace Kernel {
@@ -1057,6 +1072,17 @@ export declare namespace Kernel {
     type CredentialListParams as CredentialListParams,
   };
 
+  export {
+    Projects as Projects,
+    type CreateProjectRequest as CreateProjectRequest,
+    type Project as Project,
+    type UpdateProjectRequest as UpdateProjectRequest,
+    type ProjectsOffsetPagination as ProjectsOffsetPagination,
+    type ProjectCreateParams as ProjectCreateParams,
+    type ProjectUpdateParams as ProjectUpdateParams,
+    type ProjectListParams as ProjectListParams,
+  };
+
   export {
     CredentialProviders as CredentialProviders,
     type CreateCredentialProviderRequest as CreateCredentialProviderRequest,

package/src/internal/utils/env.ts

@@ -9,10 +9,10 @@
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof (globalThis as any).process !== 'undefined') {
-    return (globalThis as any).process.env?.[env]?.trim() ?? undefined;
+    return (globalThis as any).process.env?.[env]?.trim() || undefined;
   }
   if (typeof (globalThis as any).Deno !== 'undefined') {
-    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+    return (globalThis as any).Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };

package/src/resources/browser-pools.ts

@@ -305,6 +305,11 @@ export interface BrowserPoolAcquireResponse {
    */
   webdriver_ws_url: string;
 
+  /**
+   * Metro-API HTTP base URL for this browser session.
+   */
+  base_url?: string;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.

package/src/resources/browsers/browsers.ts

@@ -318,6 +318,11 @@ export interface BrowserCreateResponse {
    */
   webdriver_ws_url: string;
 
+  /**
+   * Metro-API HTTP base URL for this browser session.
+   */
+  base_url?: string;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.
@@ -419,6 +424,11 @@ export interface BrowserRetrieveResponse {
    */
   webdriver_ws_url: string;
 
+  /**
+   * Metro-API HTTP base URL for this browser session.
+   */
+  base_url?: string;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.
@@ -520,6 +530,11 @@ export interface BrowserUpdateResponse {
    */
   webdriver_ws_url: string;
 
+  /**
+   * Metro-API HTTP base URL for this browser session.
+   */
+  base_url?: string;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.
@@ -621,6 +636,11 @@ export interface BrowserListResponse {
    */
   webdriver_ws_url: string;
 
+  /**
+   * Metro-API HTTP base URL for this browser session.
+   */
+  base_url?: string;
+
   /**
    * Remote URL for live viewing the browser session. Only available for non-headless
    * browsers.
@@ -821,7 +841,7 @@ export interface BrowserListParams extends OffsetPaginationParams {
   include_deleted?: boolean;
 
   /**
-   * Search browsers by session ID, profile ID, or proxy ID.
+   * Search browsers by session ID, profile ID, proxy ID, or pool name.
    */
   query?: string;
 

package/src/resources/browsers/replays.ts

@@ -143,7 +143,8 @@ export interface ReplayDownloadParams {
 
 export interface ReplayStartParams {
   /**
-   * Recording framerate in fps.
+   * Recording framerate in fps. Values above 20 require GPU to be enabled on the
+   * browser session.
    */
   framerate?: number;
 

package/src/resources/index.ts

@@ -96,6 +96,16 @@ export {
   type InvocationListResponsesOffsetPagination,
 } from './invocations';
 export { Profiles, type ProfileCreateParams, type ProfileListParams } from './profiles';
+export {
+  Projects,
+  type CreateProjectRequest,
+  type Project,
+  type UpdateProjectRequest,
+  type ProjectCreateParams,
+  type ProjectUpdateParams,
+  type ProjectListParams,
+  type ProjectsOffsetPagination,
+} from './projects/projects';
 export {
   Proxies,
   type ProxyCreateResponse,

package/src/resources/invocations.ts

@@ -453,6 +453,11 @@ export namespace InvocationListBrowsersResponse {
      */
     webdriver_ws_url: string;
 
+    /**
+     * Metro-API HTTP base URL for this browser session.
+     */
+    base_url?: string;
+
     /**
      * Remote URL for live viewing the browser session. Only available for non-headless
      * browsers.

package/src/resources/projects/index.ts

@@ -0,0 +1,18 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Limits,
+  type ProjectLimits,
+  type UpdateProjectLimitsRequest,
+  type LimitUpdateParams,
+} from './limits';
+export {
+  Projects,
+  type CreateProjectRequest,
+  type Project,
+  type UpdateProjectRequest,
+  type ProjectCreateParams,
+  type ProjectUpdateParams,
+  type ProjectListParams,
+  type ProjectsOffsetPagination,
+} from './projects';

package/src/resources/projects/limits.ts

@@ -0,0 +1,128 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Create and manage projects for resource isolation within an organization.
+ */
+export class Limits extends APIResource {
+  /**
+   * Get the resource limit overrides for a project. Null values mean no
+   * project-level cap (org limit applies).
+   *
+   * @example
+   * ```ts
+   * const projectLimits = await client.projects.limits.retrieve(
+   *   'id',
+   * );
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<ProjectLimits> {
+    return this._client.get(path`/projects/${id}/limits`, options);
+  }
+
+  /**
+   * Update resource limit overrides for a project. Only fields present in the
+   * request are modified. Set a field to 0 to remove that limit cap; omit a field to
+   * leave it unchanged.
+   *
+   * @example
+   * ```ts
+   * const projectLimits = await client.projects.limits.update(
+   *   'id',
+   * );
+   * ```
+   */
+  update(id: string, body: LimitUpdateParams, options?: RequestOptions): APIPromise<ProjectLimits> {
+    return this._client.patch(path`/projects/${id}/limits`, { body, ...options });
+  }
+}
+
+export interface ProjectLimits {
+  /**
+   * Maximum concurrent app invocations for this project. Null means no project-level
+   * cap.
+   */
+  max_concurrent_invocations?: number | null;
+
+  /**
+   * Maximum concurrent browser sessions for this project. Null means no
+   * project-level cap.
+   */
+  max_concurrent_sessions?: number | null;
+
+  /**
+   * Maximum persistent browser sessions for this project. Null means no
+   * project-level cap.
+   */
+  max_persistent_sessions?: number | null;
+
+  /**
+   * Maximum pooled sessions capacity for this project. Null means no project-level
+   * cap.
+   */
+  max_pooled_sessions?: number | null;
+}
+
+export interface UpdateProjectLimitsRequest {
+  /**
+   * Maximum concurrent app invocations for this project. Set to 0 to remove the cap;
+   * omit to leave unchanged.
+   */
+  max_concurrent_invocations?: number | null;
+
+  /**
+   * Maximum concurrent browser sessions for this project. Set to 0 to remove the
+   * cap; omit to leave unchanged.
+   */
+  max_concurrent_sessions?: number | null;
+
+  /**
+   * Maximum persistent browser sessions for this project. Set to 0 to remove the
+   * cap; omit to leave unchanged.
+   */
+  max_persistent_sessions?: number | null;
+
+  /**
+   * Maximum pooled sessions capacity for this project. Set to 0 to remove the cap;
+   * omit to leave unchanged.
+   */
+  max_pooled_sessions?: number | null;
+}
+
+export interface LimitUpdateParams {
+  /**
+   * Maximum concurrent app invocations for this project. Set to 0 to remove the cap;
+   * omit to leave unchanged.
+   */
+  max_concurrent_invocations?: number | null;
+
+  /**
+   * Maximum concurrent browser sessions for this project. Set to 0 to remove the
+   * cap; omit to leave unchanged.
+   */
+  max_concurrent_sessions?: number | null;
+
+  /**
+   * Maximum persistent browser sessions for this project. Set to 0 to remove the
+   * cap; omit to leave unchanged.
+   */
+  max_persistent_sessions?: number | null;
+
+  /**
+   * Maximum pooled sessions capacity for this project. Set to 0 to remove the cap;
+   * omit to leave unchanged.
+   */
+  max_pooled_sessions?: number | null;
+}
+
+export declare namespace Limits {
+  export {
+    type ProjectLimits as ProjectLimits,
+    type UpdateProjectLimitsRequest as UpdateProjectLimitsRequest,
+    type LimitUpdateParams as LimitUpdateParams,
+  };
+}

package/src/resources/projects/projects.ts

@@ -0,0 +1,179 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as LimitsAPI from './limits';
+import { LimitUpdateParams, Limits, ProjectLimits, UpdateProjectLimitsRequest } from './limits';
+import { APIPromise } from '../../core/api-promise';
+import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Create and manage projects for resource isolation within an organization.
+ */
+export class Projects extends APIResource {
+  limits: LimitsAPI.Limits = new LimitsAPI.Limits(this._client);
+
+  /**
+   * Create a new project within the authenticated organization. Requires a paid plan
+   * and the projects feature flag.
+   *
+   * @example
+   * ```ts
+   * const project = await client.projects.create({
+   *   name: 'staging',
+   * });
+   * ```
+   */
+  create(body: ProjectCreateParams, options?: RequestOptions): APIPromise<Project> {
+    return this._client.post('/projects', { body, ...options });
+  }
+
+  /**
+   * Get a project by ID.
+   *
+   * @example
+   * ```ts
+   * const project = await client.projects.retrieve('id');
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<Project> {
+    return this._client.get(path`/projects/${id}`, options);
+  }
+
+  /**
+   * Update a project's name or status.
+   *
+   * @example
+   * ```ts
+   * const project = await client.projects.update('id');
+   * ```
+   */
+  update(id: string, body: ProjectUpdateParams, options?: RequestOptions): APIPromise<Project> {
+    return this._client.patch(path`/projects/${id}`, { body, ...options });
+  }
+
+  /**
+   * List projects for the authenticated organization.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const project of client.projects.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: ProjectListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ProjectsOffsetPagination, Project> {
+    return this._client.getAPIList('/projects', OffsetPagination<Project>, { query, ...options });
+  }
+
+  /**
+   * Soft-delete a project. The project must be empty (no active resources).
+   *
+   * @example
+   * ```ts
+   * await client.projects.delete('id');
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/projects/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type ProjectsOffsetPagination = OffsetPagination<Project>;
+
+export interface CreateProjectRequest {
+  /**
+   * Project name (1-255 characters)
+   */
+  name: string;
+}
+
+export interface Project {
+  /**
+   * Unique project identifier
+   */
+  id: string;
+
+  /**
+   * When the project was created
+   */
+  created_at: string;
+
+  /**
+   * Project name
+   */
+  name: string;
+
+  /**
+   * Project status
+   */
+  status: 'active' | 'archived';
+
+  /**
+   * When the project was last updated
+   */
+  updated_at: string;
+}
+
+export interface UpdateProjectRequest {
+  /**
+   * New project name
+   */
+  name?: string;
+
+  /**
+   * New project status
+   */
+  status?: 'active' | 'archived';
+}
+
+export interface ProjectCreateParams {
+  /**
+   * Project name (1-255 characters)
+   */
+  name: string;
+}
+
+export interface ProjectUpdateParams {
+  /**
+   * New project name
+   */
+  name?: string;
+
+  /**
+   * New project status
+   */
+  status?: 'active' | 'archived';
+}
+
+export interface ProjectListParams extends OffsetPaginationParams {}
+
+Projects.Limits = Limits;
+
+export declare namespace Projects {
+  export {
+    type CreateProjectRequest as CreateProjectRequest,
+    type Project as Project,
+    type UpdateProjectRequest as UpdateProjectRequest,
+    type ProjectsOffsetPagination as ProjectsOffsetPagination,
+    type ProjectCreateParams as ProjectCreateParams,
+    type ProjectUpdateParams as ProjectUpdateParams,
+    type ProjectListParams as ProjectListParams,
+  };
+
+  export {
+    Limits as Limits,
+    type ProjectLimits as ProjectLimits,
+    type UpdateProjectLimitsRequest as UpdateProjectLimitsRequest,
+    type LimitUpdateParams as LimitUpdateParams,
+  };
+}

package/src/resources/projects.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './projects/index';

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.47.0'; // x-release-please-version
+export const VERSION = '0.49.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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