@onkernel/sdk 0.46.0 → 0.48.0

package/resources/projects/projects.js

@@ -0,0 +1,87 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Projects = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const LimitsAPI = tslib_1.__importStar(require("./limits.js"));
+const limits_1 = require("./limits.js");
+const pagination_1 = require("../../core/pagination.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Create and manage projects for resource isolation within an organization.
+ */
+class Projects extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.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, options) {
+        return this._client.post('/projects', { body, ...options });
+    }
+    /**
+     * Get a project by ID.
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.retrieve('id');
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/projects/${id}`, options);
+    }
+    /**
+     * Update a project's name or status.
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.update('id');
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch((0, path_1.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 = {}, options) {
+        return this._client.getAPIList('/projects', (pagination_1.OffsetPagination), { query, ...options });
+    }
+    /**
+     * Soft-delete a project. The project must be empty (no active resources).
+     *
+     * @example
+     * ```ts
+     * await client.projects.delete('id');
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/projects/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Projects = Projects;
+Projects.Limits = limits_1.Limits;
+//# sourceMappingURL=projects.js.map

package/resources/projects/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/resources/projects/projects.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,+DAAsC;AACtC,wCAAgG;AAEhG,yDAAmG;AACnG,uDAAsD;AAEtD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAyEhE,CAAC;IAvEC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,6BAAyB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,EAAE,EAAE,EAAE;YAChD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AA1ED,4BA0EC;AAuED,QAAQ,CAAC,MAAM,GAAG,eAAM,CAAC"}

package/resources/projects/projects.mjs

@@ -0,0 +1,82 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as LimitsAPI from "./limits.mjs";
+import { Limits } from "./limits.mjs";
+import { OffsetPagination } from "../../core/pagination.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * Create and manage projects for resource isolation within an organization.
+ */
+export class Projects extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.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, options) {
+        return this._client.post('/projects', { body, ...options });
+    }
+    /**
+     * Get a project by ID.
+     *
+     * @example
+     * ```ts
+     * const project = await client.projects.retrieve('id');
+     * ```
+     */
+    retrieve(id, options) {
+        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, body, options) {
+        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 = {}, options) {
+        return this._client.getAPIList('/projects', (OffsetPagination), { query, ...options });
+    }
+    /**
+     * Soft-delete a project. The project must be empty (no active resources).
+     *
+     * @example
+     * ```ts
+     * await client.projects.delete('id');
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete(path `/projects/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+Projects.Limits = Limits;
+//# sourceMappingURL=projects.mjs.map

package/resources/projects/projects.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.mjs","sourceRoot":"","sources":["../../src/resources/projects/projects.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,SAAS;OACd,EAAqB,MAAM,EAA6C;OAExE,EAAE,gBAAgB,EAA4C;OAC9D,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAyEhE,CAAC;IAvEC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA,gBAAyB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,EAAE,EAAE,EAAE;YAChD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAuED,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC"}

package/resources/projects.d.mts

@@ -0,0 +1,2 @@
+export * from "./projects/index.mjs";
+//# sourceMappingURL=projects.d.mts.map

package/resources/projects.d.mts.map

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

package/resources/projects.d.ts

@@ -0,0 +1,2 @@
+export * from "./projects/index.js";
+//# sourceMappingURL=projects.d.ts.map

package/resources/projects.d.ts.map

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

package/resources/projects.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./projects/index.js"), exports);
+//# sourceMappingURL=projects.js.map

package/resources/projects.js.map

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

package/resources/projects.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./projects/index.mjs";
+//# sourceMappingURL=projects.mjs.map

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/auth/connections.ts

@@ -14,8 +14,9 @@ import { path } from '../../internal/utils/path';
  */
 export class Connections extends APIResource {
   /**
-   * Creates an auth connection for a profile and domain combination. Returns 409
-   * Conflict if an auth connection already exists for the given profile and domain.
+   * Creates an auth connection for a profile and domain combination. If the provided
+   * profile_name does not exist, it is created automatically. Returns 409 Conflict
+   * if an auth connection already exists for the given profile and domain.
    *
    * @example
    * ```ts
@@ -334,6 +335,11 @@ export interface ManagedAuth {
    */
   live_view_url?: string | null;
 
+  /**
+   * Optional login page URL to skip discovery
+   */
+  login_url?: string;
+
   /**
    * MFA method options (present when flow_step=awaiting_input and MFA selection
    * required)
@@ -521,7 +527,8 @@ export interface ManagedAuthCreateRequest {
   domain: string;
 
   /**
-   * Name of the profile to manage authentication for
+   * Name of the profile to manage authentication for. If the profile does not exist,
+   * it is created automatically.
    */
   profile_name: string;
 
@@ -975,7 +982,8 @@ export interface ConnectionCreateParams {
   domain: string;
 
   /**
-   * Name of the profile to manage authentication for
+   * Name of the profile to manage authentication for. If the profile does not exist,
+   * it is created automatically.
    */
   profile_name: string;
 

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.

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,
+  };
+}