@onkernel/sdk 0.65.0 → 0.67.0

package/resources/proxies.mjs

@@ -8,19 +8,19 @@ import { path } from "../internal/utils/path.mjs";
  */
 export class Proxies extends APIResource {
     /**
-     * Create a new proxy configuration for the caller's organization.
+     * Create a new proxy configuration in the resolved project.
      */
     create(body, options) {
         return this._client.post('/proxies', { body, ...options });
     }
     /**
-     * Retrieve a proxy belonging to the caller's organization by ID.
+     * Retrieve a proxy in the resolved project by ID.
      */
     retrieve(id, options) {
         return this._client.get(path `/proxies/${id}`, options);
     }
     /**
-     * List proxies owned by the caller's organization.
+     * List proxies in the resolved project.
      */
     list(query = {}, options) {
         return this._client.getAPIList('/proxies', (OffsetPagination), { query, ...options });

package/src/client.ts

@@ -139,6 +139,7 @@ import {
   Profile,
   Tags,
 } from './resources/browsers/browsers';
+import { Organization } from './resources/organization/organization';
 import {
   CreateProjectRequest,
   Project,
@@ -174,6 +175,8 @@ export interface ClientOptions {
    */
   apiKey?: string | undefined;
 
+  projectID?: string | null | undefined;
+
   /**
    * Specifies the environment to use for the API.
    *
@@ -257,6 +260,7 @@ export interface ClientOptions {
  */
 export class Kernel {
   apiKey: string;
+  projectID: string | null;
 
   baseURL: string;
   maxRetries: number;
@@ -276,6 +280,7 @@ export class Kernel {
    * API Client for interfacing with the Kernel API.
    *
    * @param {string | undefined} [opts.apiKey=process.env['KERNEL_API_KEY'] ?? undefined]
+   * @param {string | null | undefined} [opts.projectID]
    * @param {Environment} [opts.environment=production] - Specifies the environment URL to use for the API.
    * @param {string} [opts.baseURL=process.env['KERNEL_BASE_URL'] ?? https://api.onkernel.com/] - Override the default base URL for the API.
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
@@ -288,6 +293,7 @@ export class Kernel {
   constructor({
     baseURL = readEnv('KERNEL_BASE_URL'),
     apiKey = readEnv('KERNEL_API_KEY'),
+    projectID = null,
     ...opts
   }: ClientOptions = {}) {
     // Check for Bun runtime in a way that avoids type errors if Bun is not defined
@@ -310,6 +316,7 @@ export class Kernel {
 
     const options: ClientOptions = {
       apiKey,
+      projectID,
       ...opts,
       baseURL,
       environment: opts.environment ?? 'production',
@@ -357,6 +364,7 @@ export class Kernel {
     this._options = options;
 
     this.apiKey = apiKey;
+    this.projectID = projectID;
   }
 
   /**
@@ -374,6 +382,7 @@ export class Kernel {
       fetch: this.rawFetch,
       fetchOptions: this.fetchOptions,
       apiKey: this.apiKey,
+      projectID: this.projectID,
       ...options,
     });
     client.browserRouteCache = this.browserRouteCache;
@@ -850,6 +859,7 @@ export class Kernel {
         'X-Stainless-Retry-Count': String(retryCount),
         ...(options.timeout ? { 'X-Stainless-Timeout': String(Math.trunc(options.timeout / 1000)) } : {}),
         ...getPlatformHeaders(),
+        'X-Kernel-Project-Id': this.projectID,
       },
       await this.authHeaders(options),
       this._options.defaultHeaders,
@@ -983,6 +993,7 @@ export class Kernel {
    * Create and manage projects for resource isolation within an organization.
    */
   projects: API.Projects = new API.Projects(this);
+  organization: API.Organization = new API.Organization(this);
   /**
    * Create and manage API keys for organization and project-scoped access.
    */
@@ -1004,6 +1015,7 @@ Kernel.Extensions = Extensions;
 Kernel.BrowserPools = BrowserPools;
 Kernel.Credentials = Credentials;
 Kernel.Projects = Projects;
+Kernel.Organization = Organization;
 Kernel.APIKeys = APIKeys;
 Kernel.CredentialProviders = CredentialProviders;
 
@@ -1138,6 +1150,8 @@ export declare namespace Kernel {
     type ProjectListParams as ProjectListParams,
   };
 
+  export { Organization as Organization };
+
   export {
     APIKeys as APIKeys,
     type APIKey as APIKey,

package/src/resources/auth/connections.ts

@@ -699,8 +699,8 @@ export interface ManagedAuthCreateRequest {
   login_url?: string;
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   proxy?: ManagedAuthCreateRequest.Proxy;
 
@@ -748,8 +748,8 @@ export namespace ManagedAuthCreateRequest {
   }
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   export interface Proxy {
     /**
@@ -812,8 +812,8 @@ export interface ManagedAuthUpdateRequest {
   login_url?: string;
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   proxy?: ManagedAuthUpdateRequest.Proxy;
 
@@ -859,8 +859,8 @@ export namespace ManagedAuthUpdateRequest {
   }
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   export interface Proxy {
     /**
@@ -1215,8 +1215,8 @@ export interface ConnectionCreateParams {
   login_url?: string;
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   proxy?: ConnectionCreateParams.Proxy;
 
@@ -1264,8 +1264,8 @@ export namespace ConnectionCreateParams {
   }
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   export interface Proxy {
     /**
@@ -1325,8 +1325,8 @@ export interface ConnectionUpdateParams {
   login_url?: string;
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   proxy?: ConnectionUpdateParams.Proxy;
 
@@ -1372,8 +1372,8 @@ export namespace ConnectionUpdateParams {
   }
 
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   export interface Proxy {
     /**
@@ -1402,8 +1402,8 @@ export interface ConnectionListParams extends OffsetPaginationParams {
 
 export interface ConnectionLoginParams {
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   proxy?: ConnectionLoginParams.Proxy;
 
@@ -1416,8 +1416,8 @@ export interface ConnectionLoginParams {
 
 export namespace ConnectionLoginParams {
   /**
-   * Proxy selection. Provide either id or name. The proxy must belong to the
-   * caller's org.
+   * Proxy selection. Provide either id or name. The proxy must be in the same
+   * project as the resource referencing it.
    */
   export interface Proxy {
     /**

package/src/resources/browser-pools.ts

@@ -57,7 +57,7 @@ export class BrowserPools extends APIResource {
   }
 
   /**
-   * List browser pools owned by the caller's organization.
+   * List browser pools in the resolved project.
    *
    * @example
    * ```ts
@@ -241,8 +241,8 @@ export namespace BrowserPool {
     profile?: Shared.BrowserProfile;
 
     /**
-     * Optional proxy to associate to the browser session. Must reference a proxy
-     * belonging to the caller's org.
+     * Optional proxy to associate to the browser session. Must reference a proxy in
+     * the same project as the browser session.
      */
     proxy_id?: string;
 
@@ -467,8 +467,8 @@ export interface BrowserPoolCreateParams {
   profile?: Shared.BrowserProfile;
 
   /**
-   * Optional proxy to associate to the browser session. Must reference a proxy
-   * belonging to the caller's org.
+   * Optional proxy to associate to the browser session. Must reference a proxy in
+   * the same project as the browser session.
    */
   proxy_id?: string;
 
@@ -559,8 +559,8 @@ export interface BrowserPoolUpdateParams {
   profile?: Shared.BrowserProfile;
 
   /**
-   * Optional proxy to associate to the browser session. Must reference a proxy
-   * belonging to the caller's org.
+   * Optional proxy to associate to the browser session. Must reference a proxy in
+   * the same project as the browser session.
    */
   proxy_id?: string;
 

package/src/resources/browsers/browsers.ts

@@ -928,8 +928,8 @@ export interface BrowserCreateParams {
 
   /**
    * Optional human-readable name for the browser session, used to find it later in
-   * the dashboard. Must be unique among active sessions within the project. Set at
-   * creation time only.
+   * the dashboard. Must be unique among active sessions within the project. Can be
+   * changed later via PATCH /browsers/{id_or_name}.
    */
   name?: string;
 
@@ -941,8 +941,8 @@ export interface BrowserCreateParams {
   profile?: Shared.BrowserProfile;
 
   /**
-   * Optional proxy to associate to the browser session. Must reference a proxy
-   * belonging to the caller's org.
+   * Optional proxy to associate to the browser session. Must reference a proxy in
+   * the same project as the browser session.
    */
   proxy_id?: string;
 
@@ -961,7 +961,8 @@ export interface BrowserCreateParams {
 
   /**
    * Optional user-defined key-value tags for the browser session, used to find and
-   * group sessions later. Set at creation time only. Up to 50 pairs.
+   * group sessions later. Can be changed later via PATCH /browsers/{id_or_name}. Up
+   * to 50 pairs.
    */
   tags?: Tags;
 
@@ -1041,6 +1042,13 @@ export interface BrowserUpdateParams {
    */
   disable_default_proxy?: boolean;
 
+  /**
+   * Human-readable name for the browser session. Omit to leave unchanged, set to an
+   * empty string to clear the name. When set, must be unique among active sessions
+   * within the project.
+   */
+  name?: string | null;
+
   /**
    * Profile to load into the browser session. Only allowed if the session does not
    * already have a profile loaded.
@@ -1053,6 +1061,13 @@ export interface BrowserUpdateParams {
    */
   proxy_id?: string | null;
 
+  /**
+   * User-defined key-value tags for the browser session. Omit to leave unchanged.
+   * Provide a map to replace the entire tag set (full replace, not a merge). Set to
+   * an empty object ({}) to clear all tags. Up to 50 pairs.
+   */
+  tags?: Tags | null;
+
   /**
    * Telemetry configuration. Omit, set to null, or set to an empty object ({}) to
    * leave the existing configuration unchanged. Set enabled to true to enable

package/src/resources/credentials.ts

@@ -60,8 +60,7 @@ export class Credentials extends APIResource {
   }
 
   /**
-   * List credentials owned by the caller's organization. Credential values are not
-   * returned.
+   * List credentials in the resolved project. Credential values are not returned.
    *
    * @example
    * ```ts

package/src/resources/extensions.ts

@@ -14,7 +14,7 @@ import { path } from '../internal/utils/path';
  */
 export class Extensions extends APIResource {
   /**
-   * List extensions owned by the caller's organization.
+   * List extensions in the resolved project.
    *
    * @example
    * ```ts

package/src/resources/index.ts

@@ -109,6 +109,7 @@ export {
   type InvocationFollowParams,
   type InvocationListResponsesOffsetPagination,
 } from './invocations';
+export { Organization } from './organization/organization';
 export { Profiles, type ProfileCreateParams, type ProfileListParams } from './profiles';
 export {
   Projects,

package/src/resources/organization/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Limits, type OrgLimits, type UpdateOrgLimitsRequest, type LimitUpdateParams } from './limits';
+export { Organization } from './organization';

package/src/resources/organization/limits.ts

@@ -0,0 +1,71 @@
+// 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';
+
+/**
+ * Read and manage organization-level limits.
+ */
+export class Limits extends APIResource {
+  /**
+   * Get the organization's concurrent session ceiling and the default per-project
+   * concurrency cap applied to projects without an explicit override.
+   */
+  retrieve(options?: RequestOptions): APIPromise<OrgLimits> {
+    return this._client.get('/org/limits', options);
+  }
+
+  /**
+   * Set the default per-project concurrency cap applied to projects without an
+   * explicit override. Set the value to 0 to remove the default; omit to leave it
+   * unchanged. The default cannot exceed the organization's concurrent session
+   * ceiling.
+   */
+  update(body: LimitUpdateParams, options?: RequestOptions): APIPromise<OrgLimits> {
+    return this._client.patch('/org/limits', { body, ...options });
+  }
+}
+
+export interface OrgLimits {
+  /**
+   * Default maximum concurrent browser sessions applied to every project that has no
+   * explicit per-project override. Null means no org-level default, so such projects
+   * are uncapped (only the org-wide limit applies). Applies to existing and newly
+   * created projects.
+   */
+  default_project_max_concurrent_sessions?: number | null;
+
+  /**
+   * The organization's effective concurrent browser session ceiling, from its plan
+   * or an override. Read-only and shared across all projects in the org; a
+   * per-project default cannot exceed it.
+   */
+  max_concurrent_sessions?: number;
+}
+
+export interface UpdateOrgLimitsRequest {
+  /**
+   * Default maximum concurrent browser sessions for projects without an explicit
+   * override. Set to 0 to remove the default; omit to leave unchanged. Cannot exceed
+   * the organization's concurrent session ceiling.
+   */
+  default_project_max_concurrent_sessions?: number | null;
+}
+
+export interface LimitUpdateParams {
+  /**
+   * Default maximum concurrent browser sessions for projects without an explicit
+   * override. Set to 0 to remove the default; omit to leave unchanged. Cannot exceed
+   * the organization's concurrent session ceiling.
+   */
+  default_project_max_concurrent_sessions?: number | null;
+}
+
+export declare namespace Limits {
+  export {
+    type OrgLimits as OrgLimits,
+    type UpdateOrgLimitsRequest as UpdateOrgLimitsRequest,
+    type LimitUpdateParams as LimitUpdateParams,
+  };
+}

package/src/resources/organization/organization.ts

@@ -0,0 +1,20 @@
+// 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, OrgLimits, UpdateOrgLimitsRequest } from './limits';
+
+export class Organization extends APIResource {
+  limits: LimitsAPI.Limits = new LimitsAPI.Limits(this._client);
+}
+
+Organization.Limits = Limits;
+
+export declare namespace Organization {
+  export {
+    Limits as Limits,
+    type OrgLimits as OrgLimits,
+    type UpdateOrgLimitsRequest as UpdateOrgLimitsRequest,
+    type LimitUpdateParams as LimitUpdateParams,
+  };
+}

package/src/resources/organization.ts

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

package/src/resources/proxies.ts

@@ -12,21 +12,21 @@ import { path } from '../internal/utils/path';
  */
 export class Proxies extends APIResource {
   /**
-   * Create a new proxy configuration for the caller's organization.
+   * Create a new proxy configuration in the resolved project.
    */
   create(body: ProxyCreateParams, options?: RequestOptions): APIPromise<ProxyCreateResponse> {
     return this._client.post('/proxies', { body, ...options });
   }
 
   /**
-   * Retrieve a proxy belonging to the caller's organization by ID.
+   * Retrieve a proxy in the resolved project by ID.
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<ProxyRetrieveResponse> {
     return this._client.get(path`/proxies/${id}`, options);
   }
 
   /**
-   * List proxies owned by the caller's organization.
+   * List proxies in the resolved project.
    */
   list(
     query: ProxyListParams | null | undefined = {},

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.65.0'; // x-release-please-version
+export const VERSION = '0.67.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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