@onkernel/sdk 0.57.0 → 0.58.0

package/src/resources/api-keys.ts

@@ -0,0 +1,195 @@
+// 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 { 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 API keys for organization and project-scoped access.
+ */
+export class APIKeys extends APIResource {
+  /**
+   * Create a new API key within the authenticated organization.
+   *
+   * @example
+   * ```ts
+   * const createdAPIKey = await client.apiKeys.create({
+   *   name: 'staging',
+   * });
+   * ```
+   */
+  create(body: APIKeyCreateParams, options?: RequestOptions): APIPromise<CreatedAPIKey> {
+    return this._client.post('/org/api_keys', { body, ...options });
+  }
+
+  /**
+   * Retrieve an API key by ID for the authenticated organization. API keys are
+   * masked.
+   *
+   * @example
+   * ```ts
+   * const apiKey = await client.apiKeys.retrieve('id');
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<APIKey> {
+    return this._client.get(path`/org/api_keys/${id}`, options);
+  }
+
+  /**
+   * Update an API key's name.
+   *
+   * @example
+   * ```ts
+   * const apiKey = await client.apiKeys.update('id', {
+   *   name: 'new-api-name',
+   * });
+   * ```
+   */
+  update(id: string, body: APIKeyUpdateParams, options?: RequestOptions): APIPromise<APIKey> {
+    return this._client.patch(path`/org/api_keys/${id}`, { body, ...options });
+  }
+
+  /**
+   * List API keys for the authenticated organization. API keys are masked.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const apiKey of client.apiKeys.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: APIKeyListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<APIKeysOffsetPagination, APIKey> {
+    return this._client.getAPIList('/org/api_keys', OffsetPagination<APIKey>, { query, ...options });
+  }
+
+  /**
+   * Delete an API key.
+   *
+   * @example
+   * ```ts
+   * await client.apiKeys.delete('id');
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/org/api_keys/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type APIKeysOffsetPagination = OffsetPagination<APIKey>;
+
+export interface APIKey {
+  /**
+   * Unique API key identifier
+   */
+  id: string;
+
+  /**
+   * When the API key was created
+   */
+  created_at: string;
+
+  created_by: APIKey.CreatedBy;
+
+  /**
+   * When the API key expires
+   */
+  expires_at: string | null;
+
+  /**
+   * Masked version of the API key
+   */
+  masked_key: string;
+
+  /**
+   * API key name
+   */
+  name: string;
+
+  /**
+   * Project identifier for project-scoped API keys. Null means org-wide.
+   */
+  project_id: string | null;
+
+  /**
+   * Project name for project-scoped API keys. Null means the key is org-wide or the
+   * project name is unavailable.
+   */
+  project_name: string | null;
+}
+
+export namespace APIKey {
+  export interface CreatedBy {
+    /**
+     * Kernel user ID of the creator.
+     */
+    id: string;
+
+    /**
+     * Email address of the creator.
+     */
+    email: string;
+
+    /**
+     * Display name of the creator, if available.
+     */
+    name: string | null;
+  }
+}
+
+/**
+ * API key returned immediately after creation. Includes the plaintext key once.
+ */
+export interface CreatedAPIKey extends APIKey {
+  /**
+   * Plaintext API key. Only returned once when the key is created.
+   */
+  key: string;
+}
+
+export interface APIKeyCreateParams {
+  /**
+   * API key name (1-255 characters)
+   */
+  name: string;
+
+  /**
+   * Number of days until expiry, up to 3650. Use null for never.
+   */
+  days_to_expire?: number | null;
+
+  /**
+   * Unique project identifier
+   */
+  project_id?: string | null;
+}
+
+export interface APIKeyUpdateParams {
+  /**
+   * New API key name
+   */
+  name: string;
+}
+
+export interface APIKeyListParams extends OffsetPaginationParams {}
+
+export declare namespace APIKeys {
+  export {
+    type APIKey as APIKey,
+    type CreatedAPIKey as CreatedAPIKey,
+    type APIKeysOffsetPagination as APIKeysOffsetPagination,
+    type APIKeyCreateParams as APIKeyCreateParams,
+    type APIKeyUpdateParams as APIKeyUpdateParams,
+    type APIKeyListParams as APIKeyListParams,
+  };
+}

package/src/resources/browsers/browsers.ts

@@ -83,8 +83,7 @@ import {
   BrowserTelemetryCategoryConfig,
   BrowserTelemetryConfig,
   BrowserTelemetryEvent,
-  BrowserTelemetryRequestConfig,
-  Telemetry,
+  Telemetry as TelemetryAPITelemetry,
   TelemetryStreamParams,
   TelemetryStreamResponse,
 } from './telemetry';
@@ -899,7 +898,7 @@ export interface BrowserCreateParams {
    * category settings, or all four categories are explicitly disabled, capture is
    * not started.
    */
-  telemetry?: TelemetryAPI.BrowserTelemetryRequestConfig | null;
+  telemetry?: BrowserCreateParams.Telemetry | null;
 
   /**
    * The number of seconds of inactivity before the browser session is terminated.
@@ -927,6 +926,32 @@ export interface BrowserCreateParams {
   viewport?: Shared.BrowserViewport;
 }
 
+export namespace BrowserCreateParams {
+  /**
+   * Telemetry configuration for the browser session. Set enabled to true to start
+   * capture using VM defaults, or provide browser category settings. If omitted,
+   * null, set to an empty object ({}), set to enabled: false without browser
+   * category settings, or all four categories are explicitly disabled, capture is
+   * not started.
+   */
+  export interface Telemetry {
+    /**
+     * Per-category enable/disable flags. If enabled is true and browser is omitted or
+     * empty, the VM default category set is used. Explicitly disabling all four
+     * categories stops capture on update and starts no capture on create.
+     */
+    browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
+
+    /**
+     * Request shortcut for browser telemetry capture. True enables capture using VM
+     * defaults unless browser category settings are provided. False stops capture on
+     * update and starts no capture on create. enabled=false cannot be combined with
+     * browser category settings.
+     */
+    enabled?: boolean;
+  }
+}
+
 export interface BrowserRetrieveParams {
   /**
    * When true, includes soft-deleted browser sessions in the lookup.
@@ -960,7 +985,7 @@ export interface BrowserUpdateParams {
    * category settings for per-category updates. Explicitly disabling all four
    * categories also stops capture.
    */
-  telemetry?: TelemetryAPI.BrowserTelemetryRequestConfig | null;
+  telemetry?: BrowserUpdateParams.Telemetry | null;
 
   /**
    * Viewport configuration to apply to the browser session.
@@ -969,6 +994,30 @@ export interface BrowserUpdateParams {
 }
 
 export namespace BrowserUpdateParams {
+  /**
+   * Telemetry configuration. Omit, set to null, or set to an empty object ({}) to
+   * leave the existing configuration unchanged. Set enabled to true to enable
+   * capture using VM defaults. Set enabled to false to stop capture. Provide browser
+   * category settings for per-category updates. Explicitly disabling all four
+   * categories also stops capture.
+   */
+  export interface Telemetry {
+    /**
+     * Per-category enable/disable flags. If enabled is true and browser is omitted or
+     * empty, the VM default category set is used. Explicitly disabling all four
+     * categories stops capture on update and starts no capture on create.
+     */
+    browser?: TelemetryAPI.BrowserTelemetryCategoriesConfig;
+
+    /**
+     * Request shortcut for browser telemetry capture. True enables capture using VM
+     * defaults unless browser category settings are provided. False stops capture on
+     * update and starts no capture on create. enabled=false cannot be combined with
+     * browser category settings.
+     */
+    enabled?: boolean;
+  }
+
   /**
    * Viewport configuration to apply to the browser session.
    */
@@ -1056,7 +1105,7 @@ export namespace BrowserLoadExtensionsParams {
   }
 }
 
-Browsers.Telemetry = Telemetry;
+Browsers.Telemetry = TelemetryAPITelemetry;
 Browsers.Replays = Replays;
 Browsers.Fs = Fs;
 Browsers.Process = Process;
@@ -1084,7 +1133,7 @@ export declare namespace Browsers {
   };
 
   export {
-    Telemetry as Telemetry,
+    TelemetryAPITelemetry as Telemetry,
     type BrowserCallStack as BrowserCallStack,
     type BrowserConsoleErrorEvent as BrowserConsoleErrorEvent,
     type BrowserConsoleLogEvent as BrowserConsoleLogEvent,
@@ -1115,7 +1164,6 @@ export declare namespace Browsers {
     type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig,
     type BrowserTelemetryConfig as BrowserTelemetryConfig,
     type BrowserTelemetryEvent as BrowserTelemetryEvent,
-    type BrowserTelemetryRequestConfig as BrowserTelemetryRequestConfig,
     type TelemetryStreamResponse as TelemetryStreamResponse,
     type TelemetryStreamParams as TelemetryStreamParams,
   };

package/src/resources/browsers/index.ts

@@ -111,7 +111,6 @@ export {
   type BrowserTelemetryCategoryConfig,
   type BrowserTelemetryConfig,
   type BrowserTelemetryEvent,
-  type BrowserTelemetryRequestConfig,
   type TelemetryStreamResponse,
   type TelemetryStreamParams,
 } from './telemetry';

package/src/resources/browsers/telemetry.ts

@@ -1452,25 +1452,6 @@ export type BrowserTelemetryEvent =
   | BrowserMonitorReconnectFailedEvent
   | BrowserMonitorInitFailedEvent;
 
-/**
- * Telemetry request configuration for a browser session.
- */
-export interface BrowserTelemetryRequestConfig {
-  /**
-   * Per-category enable/disable flags. If enabled is true and browser is omitted or
-   * empty, the VM default category set is used. Explicitly disabling all four
-   * categories stops capture on update and starts no capture on create.
-   */
-  browser?: BrowserTelemetryCategoriesConfig;
-
-  /**
-   * Request shortcut for browser telemetry capture. True enables capture using VM
-   * defaults. False stops capture on update and starts no capture on create. Cannot
-   * be combined with browser category settings.
-   */
-  enabled?: boolean;
-}
-
 /**
  * Envelope wrapping a browser telemetry event with its monotonic sequence number.
  * Each SSE data: frame carries one envelope as JSON. The seq value is also emitted
@@ -1534,7 +1515,6 @@ export declare namespace Telemetry {
     type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig,
     type BrowserTelemetryConfig as BrowserTelemetryConfig,
     type BrowserTelemetryEvent as BrowserTelemetryEvent,
-    type BrowserTelemetryRequestConfig as BrowserTelemetryRequestConfig,
     type TelemetryStreamResponse as TelemetryStreamResponse,
     type TelemetryStreamParams as TelemetryStreamParams,
   };

package/src/resources/index.ts

@@ -1,6 +1,15 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export * from './shared';
+export {
+  APIKeys,
+  type APIKey,
+  type CreatedAPIKey,
+  type APIKeyCreateParams,
+  type APIKeyUpdateParams,
+  type APIKeyListParams,
+  type APIKeysOffsetPagination,
+} from './api-keys';
 export {
   Apps,
   type AppListResponse,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.57.0'; // x-release-please-version
+export const VERSION = '0.58.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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