Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "0.98.0"
".": "0.99.0"
}
2 changes: 1 addition & 1 deletion .stats.yml
Original file line number Diff line number Diff line change
@@ -1 +1 @@
configured_endpoints: 147
configured_endpoints: 158
8 changes: 8 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# Changelog

## [0.99.0](https://github.com/kernel/kernel-node-sdk/compare/v0.98.0...v0.99.0) (2026-09-04)


### Features

* Expose OTLP destination delivery health ([c393d37](https://github.com/kernel/kernel-node-sdk/commit/c393d37d72171e841f1ebf8ce0a9720f5ae271d8))
* Repair Vault SDK custom-code seals ([c6a1099](https://github.com/kernel/kernel-node-sdk/commit/c6a1099b453b25a67f54154fadec6f5b0586b472))

## [0.98.0](https://github.com/kernel/kernel-node-sdk/compare/v0.97.0...v0.98.0) (2026-09-02)


Expand Down
41 changes: 41 additions & 0 deletions api.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,7 @@ Types:
- <code><a href="./src/resources/browsers/browsers.ts">BrowserUsage</a></code>
- <code><a href="./src/resources/browsers/browsers.ts">Profile</a></code>
- <code><a href="./src/resources/browsers/browsers.ts">Tags</a></code>
- <code><a href="./src/resources/browsers/browsers.ts">VaultReference</a></code>
- <code><a href="./src/resources/browsers/browsers.ts">BrowserCreateResponse</a></code>
- <code><a href="./src/resources/browsers/browsers.ts">BrowserRetrieveResponse</a></code>
- <code><a href="./src/resources/browsers/browsers.ts">BrowserUpdateResponse</a></code>
Expand Down Expand Up @@ -432,6 +433,46 @@ Methods:
- <code title="post /browser_pools/{id_or_name}/flush">client.browserPools.<a href="./src/resources/browser-pools.ts">flush</a>(idOrName) -> void</code>
- <code title="post /browser_pools/{id_or_name}/release">client.browserPools.<a href="./src/resources/browser-pools.ts">release</a>(idOrName, { ...params }) -> void</code>

# Vaults

Types:

- <code><a href="./src/resources/vaults/vaults.ts">Vault</a></code>

Methods:

- <code title="get /vaults/{id_or_name}">client.vaults.<a href="./src/resources/vaults/vaults.ts">retrieve</a>(idOrName) -> Vault</code>
- <code title="get /vaults">client.vaults.<a href="./src/resources/vaults/vaults.ts">list</a>({ ...params }) -> VaultsOffsetPagination</code>
- <code title="delete /vaults/{id_or_name}">client.vaults.<a href="./src/resources/vaults/vaults.ts">delete</a>(idOrName) -> void</code>
- <code title="post /vaults">client.vaults.<a href="./src/resources/vaults/vaults.ts">upsert</a>({ ...params }) -> Vault</code>

## Items

Types:

- <code><a href="./src/resources/vaults/items.ts">AgentcardCheckoutAuthorization</a></code>
- <code><a href="./src/resources/vaults/items.ts">CardVaultItemSpec</a></code>
- <code><a href="./src/resources/vaults/items.ts">CardVaultItemState</a></code>
- <code><a href="./src/resources/vaults/items.ts">VaultCardAliases</a></code>
- <code><a href="./src/resources/vaults/items.ts">VaultItem</a></code>
- <code><a href="./src/resources/vaults/items.ts">VaultItemAction</a></code>
- <code><a href="./src/resources/vaults/items.ts">VaultItemEvent</a></code>
- <code><a href="./src/resources/vaults/items.ts">VaultPaymentMethod</a></code>
- <code><a href="./src/resources/vaults/items.ts">WalletVaultItemSpec</a></code>
- <code><a href="./src/resources/vaults/items.ts">WalletVaultItemState</a></code>
- <code><a href="./src/resources/vaults/items.ts">ItemListResponse</a></code>
- <code><a href="./src/resources/vaults/items.ts">ItemEventsResponse</a></code>

Methods:

- <code title="get /vaults/{id_or_name}/items/{key}">client.vaults.items.<a href="./src/resources/vaults/items.ts">retrieve</a>(key, { ...params }) -> VaultItem</code>
- <code title="patch /vaults/{id_or_name}/items/{key}">client.vaults.items.<a href="./src/resources/vaults/items.ts">update</a>(key, { ...params }) -> VaultItem</code>
- <code title="get /vaults/{id_or_name}/items">client.vaults.items.<a href="./src/resources/vaults/items.ts">list</a>(idOrName) -> ItemListResponse</code>
- <code title="delete /vaults/{id_or_name}/items/{key}">client.vaults.items.<a href="./src/resources/vaults/items.ts">delete</a>(key, { ...params }) -> void</code>
- <code title="get /vaults/{id_or_name}/items/{key}/events">client.vaults.items.<a href="./src/resources/vaults/items.ts">events</a>(key, { ...params }) -> ItemEventsResponse</code>
- <code title="post /vaults/{id_or_name}/items/{key}/operations">client.vaults.items.<a href="./src/resources/vaults/items.ts">performOperation</a>(key, { ...params }) -> VaultItem</code>
- <code title="put /vaults/{id_or_name}/items/{key}">client.vaults.items.<a href="./src/resources/vaults/items.ts">upsert</a>(key, { ...params }) -> VaultItem</code>

# Credentials

Types:
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@onkernel/sdk",
"version": "0.98.0",
"version": "0.99.0",
"description": "The official TypeScript library for the Kernel API",
"author": "Kernel <>",
"types": "dist/index.d.ts",
Expand Down
19 changes: 19 additions & 0 deletions src/client.ts
Original file line number Diff line number Diff line change
Expand Up @@ -168,6 +168,7 @@ import {
Browsers,
Profile,
Tags,
VaultReference,
} from './resources/browsers/browsers';
import {
Analysis,
Expand Down Expand Up @@ -202,6 +203,13 @@ import {
UpdateProjectRequest,
} from './resources/projects/projects';
import { Telemetry } from './resources/telemetry/telemetry';
import {
Vault,
VaultListParams,
VaultUpsertParams,
Vaults,
VaultsOffsetPagination,
} from './resources/vaults/vaults';
import { type Fetch } from './internal/builtin-types';
import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
import { FinalRequestOptions, RequestOptions } from './internal/request-options';
Expand Down Expand Up @@ -1059,6 +1067,7 @@ export class Kernel {
* Create and manage browser pools for acquiring and releasing browsers.
*/
browserPools: API.BrowserPools = new API.BrowserPools(this);
vaults: API.Vaults = new API.Vaults(this);
/**
* Create and manage credentials for authentication.
*/
Expand Down Expand Up @@ -1096,6 +1105,7 @@ Kernel.Telemetry = Telemetry;
Kernel.Proxies = Proxies;
Kernel.Extensions = Extensions;
Kernel.BrowserPools = BrowserPools;
Kernel.Vaults = Vaults;
Kernel.Credentials = Credentials;
Kernel.Projects = Projects;
Kernel.Organization = Organization;
Expand Down Expand Up @@ -1188,6 +1198,7 @@ export declare namespace Kernel {
type BrowserUsage as BrowserUsage,
type Profile as Profile,
type Tags as Tags,
type VaultReference as VaultReference,
type BrowserCreateResponse as BrowserCreateResponse,
type BrowserRetrieveResponse as BrowserRetrieveResponse,
type BrowserUpdateResponse as BrowserUpdateResponse,
Expand Down Expand Up @@ -1252,6 +1263,14 @@ export declare namespace Kernel {
type BrowserPoolReleaseParams as BrowserPoolReleaseParams,
};

export {
Vaults as Vaults,
type Vault as Vault,
type VaultsOffsetPagination as VaultsOffsetPagination,
type VaultListParams as VaultListParams,
type VaultUpsertParams as VaultUpsertParams,
};

export {
Credentials as Credentials,
type CreateCredentialRequest as CreateCredentialRequest,
Expand Down
11 changes: 11 additions & 0 deletions src/resources/browser-pools.ts
Original file line number Diff line number Diff line change
Expand Up @@ -501,6 +501,17 @@ export interface BrowserPoolAcquireResponse {
*/
usage?: BrowsersAPI.BrowserUsage;

/**
* Whether final usage billing is still pending or complete. Only present for
* deleted sessions.
*/
usage_status?: 'pending' | 'ready';

/**
* Vaults linked when the browser session was created.
*/
vaults?: Array<BrowsersAPI.VaultReference>;

/**
* Initial browser window size in pixels with optional refresh rate. If omitted,
* image defaults apply (1920x1080@25). For GPU images, the default is
Expand Down
60 changes: 60 additions & 0 deletions src/resources/browsers/browsers.ts
Original file line number Diff line number Diff line change
Expand Up @@ -479,6 +479,15 @@ export interface Profile {
*/
export type Tags = { [key: string]: string };

/**
* Reference to a project-scoped vault. Provide exactly one of id or name.
*/
export interface VaultReference {
id?: string;

name?: string;
}

export interface BrowserCreateResponse {
/**
* Websocket URL for Chrome DevTools Protocol connections to the browser session
Expand Down Expand Up @@ -622,6 +631,17 @@ export interface BrowserCreateResponse {
*/
usage?: BrowserUsage;

/**
* Whether final usage billing is still pending or complete. Only present for
* deleted sessions.
*/
usage_status?: 'pending' | 'ready';

/**
* Vaults linked when the browser session was created.
*/
vaults?: Array<VaultReference>;

/**
* Initial browser window size in pixels with optional refresh rate. If omitted,
* image defaults apply (1920x1080@25). For GPU images, the default is
Expand Down Expand Up @@ -782,6 +802,17 @@ export interface BrowserRetrieveResponse {
*/
usage?: BrowserUsage;

/**
* Whether final usage billing is still pending or complete. Only present for
* deleted sessions.
*/
usage_status?: 'pending' | 'ready';

/**
* Vaults linked when the browser session was created.
*/
vaults?: Array<VaultReference>;

/**
* Initial browser window size in pixels with optional refresh rate. If omitted,
* image defaults apply (1920x1080@25). For GPU images, the default is
Expand Down Expand Up @@ -942,6 +973,17 @@ export interface BrowserUpdateResponse {
*/
usage?: BrowserUsage;

/**
* Whether final usage billing is still pending or complete. Only present for
* deleted sessions.
*/
usage_status?: 'pending' | 'ready';

/**
* Vaults linked when the browser session was created.
*/
vaults?: Array<VaultReference>;

/**
* Initial browser window size in pixels with optional refresh rate. If omitted,
* image defaults apply (1920x1080@25). For GPU images, the default is
Expand Down Expand Up @@ -1102,6 +1144,17 @@ export interface BrowserListResponse {
*/
usage?: BrowserUsage;

/**
* Whether final usage billing is still pending or complete. Only present for
* deleted sessions.
*/
usage_status?: 'pending' | 'ready';

/**
* Vaults linked when the browser session was created.
*/
vaults?: Array<VaultReference>;

/**
* Initial browser window size in pixels with optional refresh rate. If omitted,
* image defaults apply (1920x1080@25). For GPU images, the default is
Expand Down Expand Up @@ -1270,6 +1323,12 @@ export interface BrowserCreateParams {
*/
timeout_seconds?: number;

/**
* Project-scoped vaults to link to the browser session. Links are immutable after
* creation.
*/
vaults?: Array<VaultReference>;

/**
* Initial browser window size in pixels with optional refresh rate. If omitted,
* image defaults apply (1920x1080@25). For GPU images, the default is
Expand Down Expand Up @@ -1657,6 +1716,7 @@ export declare namespace Browsers {
type BrowserUsage as BrowserUsage,
type Profile as Profile,
type Tags as Tags,
type VaultReference as VaultReference,
type BrowserCreateResponse as BrowserCreateResponse,
type BrowserRetrieveResponse as BrowserRetrieveResponse,
type BrowserUpdateResponse as BrowserUpdateResponse,
Expand Down
1 change: 1 addition & 0 deletions src/resources/browsers/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ export {
type BrowserUsage,
type Profile,
type Tags,
type VaultReference,
type BrowserCreateResponse,
type BrowserRetrieveResponse,
type BrowserUpdateResponse,
Expand Down
25 changes: 14 additions & 11 deletions src/resources/config-registry/config-registry.ts
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ export class ConfigRegistry extends APIResource {
analyses: AnalysesAPI.Analyses = new AnalysesAPI.Analyses(this._client);

/**
* Lists unique domains previously analyzed by the selected project with their
* current domain-level recommendations.
* Lists unique exact targets previously analyzed by the selected project with the
* recommendation produced by each target's latest analysis.
*
* @example
* ```ts
Expand Down Expand Up @@ -431,22 +431,24 @@ export type RecommendationResult = Recommendation | NoRecommendation;

export interface RecommendationSummary {
/**
* ID of the most recently requested analysis for this domain.
* ID of the most recently requested analysis for this exact target.
*/
analysis_id: string;

/**
* Lifecycle status of the most recently requested analysis for this domain.
* Lifecycle status of the most recently requested analysis for this exact target.
*/
analysis_status: 'running' | 'completed' | 'failed' | 'canceled';

/**
* Most recent time the selected project requested an analysis for this domain.
* Most recent time the selected project requested an analysis for this exact
* target.
*/
last_requested_at: string;

/**
* Current domain-level recommendation. Null when no eligible knowledge exists.
* Recommendation produced by the latest analysis. Null when that analysis did not
* produce one.
*/
recommendation: Recommendation | null;

Expand All @@ -456,13 +458,14 @@ export interface RecommendationSummary {
recommended_config_label: string | null;

/**
* Success rate for the recommended configuration. Null when no eligible knowledge
* exists.
* Success rate for the recommended configuration. Null when the latest analysis
* did not produce one.
*/
success_rate: number | null;

/**
* Registrable domain previously analyzed by the selected project.
* Normalized exact target previously analyzed by the selected project, including
* scheme, host, port, and path.
*/
target: string;
}
Expand Down Expand Up @@ -500,8 +503,8 @@ export interface Target {

export interface ConfigRegistryListParams extends OffsetPaginationParams {
/**
* Case-insensitive domain search. Full URLs are reduced to their registrable
* domain.
* Case-insensitive substring search over normalized targets, including domain,
* subdomain, and path.
*/
search?: string;

Expand Down
8 changes: 8 additions & 0 deletions src/resources/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ export {
type BrowserUsage,
type Profile,
type Tags,
type VaultReference,
type BrowserCreateResponse,
type BrowserRetrieveResponse,
type BrowserUpdateResponse,
Expand Down Expand Up @@ -179,3 +180,10 @@ export {
type ProxyListResponsesOffsetPagination,
} from './proxies';
export { Telemetry } from './telemetry/telemetry';
export {
Vaults,
type Vault,
type VaultListParams,
type VaultUpsertParams,
type VaultsOffsetPagination,
} from './vaults/vaults';
11 changes: 11 additions & 0 deletions src/resources/invocations.ts
Original file line number Diff line number Diff line change
Expand Up @@ -561,6 +561,17 @@ export namespace InvocationListBrowsersResponse {
*/
usage?: BrowsersAPI.BrowserUsage;

/**
* Whether final usage billing is still pending or complete. Only present for
* deleted sessions.
*/
usage_status?: 'pending' | 'ready';

/**
* Vaults linked when the browser session was created.
*/
vaults?: Array<BrowsersAPI.VaultReference>;

/**
* Initial browser window size in pixels with optional refresh rate. If omitted,
* image defaults apply (1920x1080@25). For GPU images, the default is
Expand Down
Loading
Loading