@onkernel/sdk 0.86.0 → 0.87.0

package/src/resources/auth/context.ts

@@ -0,0 +1,125 @@
+// 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';
+
+/**
+ * Inspect the identity and authorization context for the current request.
+ */
+export class Context extends APIResource {
+  /**
+   * Returns the authenticated principal, organization, credential scope, and
+   * effective request scope. The response is derived from the verified request
+   * context and does not expose credential secrets.
+   *
+   * @example
+   * ```ts
+   * const authContext = await client.auth.context.retrieve();
+   * ```
+   */
+  retrieve(options?: RequestOptions): APIPromise<AuthContext> {
+    return this._client.get('/auth/context', options);
+  }
+}
+
+/**
+ * The identity and authorization context resolved for the current request.
+ */
+export interface AuthContext {
+  authentication: AuthContext.Authentication;
+
+  /**
+   * The credential's maximum scope and the effective scope selected for this
+   * request. Future permission data can be added without changing scope semantics.
+   */
+  authorization: AuthContext.Authorization;
+
+  organization: AuthContext.Organization;
+
+  principal: AuthContext.Principal;
+}
+
+export namespace AuthContext {
+  export interface Authentication {
+    /**
+     * The API key ID when authenticated with an API key; null for session credentials.
+     */
+    credential_id: string | null;
+
+    /**
+     * The credential format used to authenticate the request.
+     */
+    method: 'api_key' | 'jwt';
+
+    /**
+     * The source classification resolved by authentication middleware.
+     */
+    source: 'api_key' | 'oauth' | 'dashboard';
+  }
+
+  /**
+   * The credential's maximum scope and the effective scope selected for this
+   * request. Future permission data can be added without changing scope semantics.
+   */
+  export interface Authorization {
+    /**
+     * A scope within the authenticated organization. A null project_id represents
+     * organization-wide scope.
+     */
+    credential_scope: Authorization.CredentialScope;
+
+    /**
+     * A scope within the authenticated organization. A null project_id represents
+     * organization-wide scope.
+     */
+    effective_scope: Authorization.EffectiveScope;
+  }
+
+  export namespace Authorization {
+    /**
+     * A scope within the authenticated organization. A null project_id represents
+     * organization-wide scope.
+     */
+    export interface CredentialScope {
+      /**
+       * The Kernel project ID, or null when the scope is organization-wide.
+       */
+      project_id: string | null;
+    }
+
+    /**
+     * A scope within the authenticated organization. A null project_id represents
+     * organization-wide scope.
+     */
+    export interface EffectiveScope {
+      /**
+       * The Kernel project ID, or null when the scope is organization-wide.
+       */
+      project_id: string | null;
+    }
+  }
+
+  export interface Organization {
+    /**
+     * The authenticated Kernel organization ID.
+     */
+    id: string;
+  }
+
+  export interface Principal {
+    /**
+     * The API key ID for API-key principals or user ID for user principals.
+     */
+    id: string;
+
+    /**
+     * The kind of principal authenticated for the request.
+     */
+    type: 'api_key' | 'user';
+  }
+}
+
+export declare namespace Context {
+  export { type AuthContext as AuthContext };
+}

package/src/resources/auth/index.ts

@@ -20,3 +20,4 @@ export {
   type ManagedAuthsOffsetPagination,
   type ManagedAuthTimelineEventsOffsetPagination,
 } from './connections';
+export { Context, type AuthContext } from './context';

package/src/resources/browser-pools.ts

@@ -432,6 +432,12 @@ export interface BrowserPoolAcquireResponse {
    */
   profile?: BrowsersAPI.Profile;
 
+  /**
+   * Whether changes made during this browser session are saved back to its profile
+   * when the session ends. Omitted when no profile is attached.
+   */
+  profile_save_changes?: boolean;
+
   /**
    * ID of the proxy associated with this browser session, if any.
    */
@@ -648,6 +654,63 @@ export namespace BrowserPoolCreateParams {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: Telemetry.Export;
+  }
+
+  export namespace Telemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 }
 
@@ -833,6 +896,63 @@ export namespace BrowserPoolUpdateParams {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: Telemetry.Export;
+  }
+
+  export namespace Telemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 }
 
@@ -939,6 +1059,63 @@ export namespace BrowserPoolAcquireParams {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: Telemetry.Export;
+  }
+
+  export namespace Telemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 }
 

package/src/resources/browsers/browsers.ts

@@ -91,6 +91,8 @@ import {
   BrowserTelemetryCategoryConfig,
   BrowserTelemetryConfig,
   BrowserTelemetryEvent,
+  BrowserTelemetryExportConfig,
+  BrowserTelemetryOtlpExportConfig,
   Telemetry as TelemetryAPITelemetry,
   TelemetryEventsParams,
   TelemetryEventsResponse,
@@ -424,6 +426,12 @@ export interface BrowserCreateResponse {
    */
   profile?: Profile;
 
+  /**
+   * Whether changes made during this browser session are saved back to its profile
+   * when the session ends. Omitted when no profile is attached.
+   */
+  profile_save_changes?: boolean;
+
   /**
    * ID of the proxy associated with this browser session, if any.
    */
@@ -556,6 +564,12 @@ export interface BrowserRetrieveResponse {
    */
   profile?: Profile;
 
+  /**
+   * Whether changes made during this browser session are saved back to its profile
+   * when the session ends. Omitted when no profile is attached.
+   */
+  profile_save_changes?: boolean;
+
   /**
    * ID of the proxy associated with this browser session, if any.
    */
@@ -688,6 +702,12 @@ export interface BrowserUpdateResponse {
    */
   profile?: Profile;
 
+  /**
+   * Whether changes made during this browser session are saved back to its profile
+   * when the session ends. Omitted when no profile is attached.
+   */
+  profile_save_changes?: boolean;
+
   /**
    * ID of the proxy associated with this browser session, if any.
    */
@@ -820,6 +840,12 @@ export interface BrowserListResponse {
    */
   profile?: Profile;
 
+  /**
+   * Whether changes made during this browser session are saved back to its profile
+   * when the session ends. Omitted when no profile is attached.
+   */
+  profile_save_changes?: boolean;
+
   /**
    * ID of the proxy associated with this browser session, if any.
    */
@@ -1037,6 +1063,63 @@ export namespace BrowserCreateParams {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: Telemetry.Export;
+  }
+
+  export namespace Telemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 }
 
@@ -1128,6 +1211,63 @@ export namespace BrowserUpdateParams {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: Telemetry.Export;
+  }
+
+  export namespace Telemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 
   /**
@@ -1152,7 +1292,7 @@ export interface BrowserListParams extends OffsetPaginationParams {
   include_deleted?: boolean;
 
   /**
-   * Search browsers by name, session ID, profile ID, proxy ID, or pool name.
+   * Search browsers by name, session ID, profile name or ID, proxy ID, or pool name.
    */
   query?: string;
 
@@ -1292,6 +1432,8 @@ export declare namespace Browsers {
     type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig,
     type BrowserTelemetryConfig as BrowserTelemetryConfig,
     type BrowserTelemetryEvent as BrowserTelemetryEvent,
+    type BrowserTelemetryExportConfig as BrowserTelemetryExportConfig,
+    type BrowserTelemetryOtlpExportConfig as BrowserTelemetryOtlpExportConfig,
     type TelemetryEventsResponse as TelemetryEventsResponse,
     type TelemetryStreamResponse as TelemetryStreamResponse,
     type TelemetryEventsResponsesOffsetPagination as TelemetryEventsResponsesOffsetPagination,

package/src/resources/browsers/index.ts

@@ -120,6 +120,8 @@ export {
   type BrowserTelemetryCategoryConfig,
   type BrowserTelemetryConfig,
   type BrowserTelemetryEvent,
+  type BrowserTelemetryExportConfig,
+  type BrowserTelemetryOtlpExportConfig,
   type TelemetryEventsResponse,
   type TelemetryStreamResponse,
   type TelemetryEventsParams,

package/src/resources/browsers/telemetry.ts

@@ -1965,6 +1965,12 @@ export interface BrowserTelemetryConfig {
    * Per-category enable/disable flags.
    */
   browser?: BrowserTelemetryCategoriesConfig;
+
+  /**
+   * Where the session's captured telemetry is being exported. Omitted when the
+   * export state is unknown.
+   */
+  export?: BrowserTelemetryExportConfig;
 }
 
 /**
@@ -2009,6 +2015,32 @@ export type BrowserTelemetryEvent =
   | BrowserSystemOomKillEvent
   | BrowserServiceCrashedEvent;
 
+/**
+ * Active export state for a session's captured telemetry, by protocol.
+ */
+export interface BrowserTelemetryExportConfig {
+  /**
+   * Active OTLP export state.
+   */
+  otlp?: BrowserTelemetryOtlpExportConfig;
+}
+
+/**
+ * Active OTLP export state for a browser session.
+ */
+export interface BrowserTelemetryOtlpExportConfig {
+  /**
+   * ID of the OTLP destination the session is bound to. Omitted when the session is
+   * not exporting.
+   */
+  destination?: string;
+
+  /**
+   * Whether the session is exporting captured telemetry over OTLP.
+   */
+  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
@@ -2158,6 +2190,8 @@ export declare namespace Telemetry {
     type BrowserTelemetryCategoryConfig as BrowserTelemetryCategoryConfig,
     type BrowserTelemetryConfig as BrowserTelemetryConfig,
     type BrowserTelemetryEvent as BrowserTelemetryEvent,
+    type BrowserTelemetryExportConfig as BrowserTelemetryExportConfig,
+    type BrowserTelemetryOtlpExportConfig as BrowserTelemetryOtlpExportConfig,
     type TelemetryEventsResponse as TelemetryEventsResponse,
     type TelemetryStreamResponse as TelemetryStreamResponse,
     type TelemetryEventsResponsesOffsetPagination as TelemetryEventsResponsesOffsetPagination,

package/src/resources/index.ts

@@ -24,7 +24,7 @@ export {
   type AuditLogListParams,
   type AuditLogExportChunkParams,
   type AuditLogEntriesPageTokenPagination,
-} from './audit-logs';
+} from './audit-logs/audit-logs';
 export { Auth } from './auth/auth';
 export {
   BrowserPools,

package/src/resources/invocations.ts

@@ -503,6 +503,12 @@ export namespace InvocationListBrowsersResponse {
      */
     profile?: BrowsersAPI.Profile;
 
+    /**
+     * Whether changes made during this browser session are saved back to its profile
+     * when the session ends. Omitted when no profile is attached.
+     */
+    profile_save_changes?: boolean;
+
     /**
      * ID of the proxy associated with this browser session, if any.
      */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.86.0'; // x-release-please-version
+export const VERSION = '0.87.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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