Skip to content

Commit ca08fa0

Browse files
Merge pull request #180 from kernel/release-please--branches--main--changes--next--components--sdk
release: 0.99.0
2 parents e96506a + 90057b5 commit ca08fa0

21 files changed

Lines changed: 1428 additions & 15 deletions

.release-please-manifest.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
{
2-
".": "0.98.0"
2+
".": "0.99.0"
33
}

.stats.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
configured_endpoints: 147
1+
configured_endpoints: 158

CHANGELOG.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,13 @@
11
# Changelog
22

3+
## [0.99.0](https://github.com/kernel/kernel-node-sdk/compare/v0.98.0...v0.99.0) (2026-09-04)
4+
5+
6+
### Features
7+
8+
* Expose OTLP destination delivery health ([c393d37](https://github.com/kernel/kernel-node-sdk/commit/c393d37d72171e841f1ebf8ce0a9720f5ae271d8))
9+
* Repair Vault SDK custom-code seals ([c6a1099](https://github.com/kernel/kernel-node-sdk/commit/c6a1099b453b25a67f54154fadec6f5b0586b472))
10+
311
## [0.98.0](https://github.com/kernel/kernel-node-sdk/compare/v0.97.0...v0.98.0) (2026-09-02)
412

513

api.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,7 @@ Types:
108108
- <code><a href="./src/resources/browsers/browsers.ts">BrowserUsage</a></code>
109109
- <code><a href="./src/resources/browsers/browsers.ts">Profile</a></code>
110110
- <code><a href="./src/resources/browsers/browsers.ts">Tags</a></code>
111+
- <code><a href="./src/resources/browsers/browsers.ts">VaultReference</a></code>
111112
- <code><a href="./src/resources/browsers/browsers.ts">BrowserCreateResponse</a></code>
112113
- <code><a href="./src/resources/browsers/browsers.ts">BrowserRetrieveResponse</a></code>
113114
- <code><a href="./src/resources/browsers/browsers.ts">BrowserUpdateResponse</a></code>
@@ -432,6 +433,46 @@ Methods:
432433
- <code title="post /browser_pools/{id_or_name}/flush">client.browserPools.<a href="./src/resources/browser-pools.ts">flush</a>(idOrName) -> void</code>
433434
- <code title="post /browser_pools/{id_or_name}/release">client.browserPools.<a href="./src/resources/browser-pools.ts">release</a>(idOrName, { ...params }) -> void</code>
434435

436+
# Vaults
437+
438+
Types:
439+
440+
- <code><a href="./src/resources/vaults/vaults.ts">Vault</a></code>
441+
442+
Methods:
443+
444+
- <code title="get /vaults/{id_or_name}">client.vaults.<a href="./src/resources/vaults/vaults.ts">retrieve</a>(idOrName) -> Vault</code>
445+
- <code title="get /vaults">client.vaults.<a href="./src/resources/vaults/vaults.ts">list</a>({ ...params }) -> VaultsOffsetPagination</code>
446+
- <code title="delete /vaults/{id_or_name}">client.vaults.<a href="./src/resources/vaults/vaults.ts">delete</a>(idOrName) -> void</code>
447+
- <code title="post /vaults">client.vaults.<a href="./src/resources/vaults/vaults.ts">upsert</a>({ ...params }) -> Vault</code>
448+
449+
## Items
450+
451+
Types:
452+
453+
- <code><a href="./src/resources/vaults/items.ts">AgentcardCheckoutAuthorization</a></code>
454+
- <code><a href="./src/resources/vaults/items.ts">CardVaultItemSpec</a></code>
455+
- <code><a href="./src/resources/vaults/items.ts">CardVaultItemState</a></code>
456+
- <code><a href="./src/resources/vaults/items.ts">VaultCardAliases</a></code>
457+
- <code><a href="./src/resources/vaults/items.ts">VaultItem</a></code>
458+
- <code><a href="./src/resources/vaults/items.ts">VaultItemAction</a></code>
459+
- <code><a href="./src/resources/vaults/items.ts">VaultItemEvent</a></code>
460+
- <code><a href="./src/resources/vaults/items.ts">VaultPaymentMethod</a></code>
461+
- <code><a href="./src/resources/vaults/items.ts">WalletVaultItemSpec</a></code>
462+
- <code><a href="./src/resources/vaults/items.ts">WalletVaultItemState</a></code>
463+
- <code><a href="./src/resources/vaults/items.ts">ItemListResponse</a></code>
464+
- <code><a href="./src/resources/vaults/items.ts">ItemEventsResponse</a></code>
465+
466+
Methods:
467+
468+
- <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>
469+
- <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>
470+
- <code title="get /vaults/{id_or_name}/items">client.vaults.items.<a href="./src/resources/vaults/items.ts">list</a>(idOrName) -> ItemListResponse</code>
471+
- <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>
472+
- <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>
473+
- <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>
474+
- <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>
475+
435476
# Credentials
436477

437478
Types:

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@onkernel/sdk",
3-
"version": "0.98.0",
3+
"version": "0.99.0",
44
"description": "The official TypeScript library for the Kernel API",
55
"author": "Kernel <>",
66
"types": "dist/index.d.ts",

src/client.ts

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -168,6 +168,7 @@ import {
168168
Browsers,
169169
Profile,
170170
Tags,
171+
VaultReference,
171172
} from './resources/browsers/browsers';
172173
import {
173174
Analysis,
@@ -202,6 +203,13 @@ import {
202203
UpdateProjectRequest,
203204
} from './resources/projects/projects';
204205
import { Telemetry } from './resources/telemetry/telemetry';
206+
import {
207+
Vault,
208+
VaultListParams,
209+
VaultUpsertParams,
210+
Vaults,
211+
VaultsOffsetPagination,
212+
} from './resources/vaults/vaults';
205213
import { type Fetch } from './internal/builtin-types';
206214
import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
207215
import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -1059,6 +1067,7 @@ export class Kernel {
10591067
* Create and manage browser pools for acquiring and releasing browsers.
10601068
*/
10611069
browserPools: API.BrowserPools = new API.BrowserPools(this);
1070+
vaults: API.Vaults = new API.Vaults(this);
10621071
/**
10631072
* Create and manage credentials for authentication.
10641073
*/
@@ -1096,6 +1105,7 @@ Kernel.Telemetry = Telemetry;
10961105
Kernel.Proxies = Proxies;
10971106
Kernel.Extensions = Extensions;
10981107
Kernel.BrowserPools = BrowserPools;
1108+
Kernel.Vaults = Vaults;
10991109
Kernel.Credentials = Credentials;
11001110
Kernel.Projects = Projects;
11011111
Kernel.Organization = Organization;
@@ -1188,6 +1198,7 @@ export declare namespace Kernel {
11881198
type BrowserUsage as BrowserUsage,
11891199
type Profile as Profile,
11901200
type Tags as Tags,
1201+
type VaultReference as VaultReference,
11911202
type BrowserCreateResponse as BrowserCreateResponse,
11921203
type BrowserRetrieveResponse as BrowserRetrieveResponse,
11931204
type BrowserUpdateResponse as BrowserUpdateResponse,
@@ -1252,6 +1263,14 @@ export declare namespace Kernel {
12521263
type BrowserPoolReleaseParams as BrowserPoolReleaseParams,
12531264
};
12541265

1266+
export {
1267+
Vaults as Vaults,
1268+
type Vault as Vault,
1269+
type VaultsOffsetPagination as VaultsOffsetPagination,
1270+
type VaultListParams as VaultListParams,
1271+
type VaultUpsertParams as VaultUpsertParams,
1272+
};
1273+
12551274
export {
12561275
Credentials as Credentials,
12571276
type CreateCredentialRequest as CreateCredentialRequest,

src/resources/browser-pools.ts

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -501,6 +501,17 @@ export interface BrowserPoolAcquireResponse {
501501
*/
502502
usage?: BrowsersAPI.BrowserUsage;
503503

504+
/**
505+
* Whether final usage billing is still pending or complete. Only present for
506+
* deleted sessions.
507+
*/
508+
usage_status?: 'pending' | 'ready';
509+
510+
/**
511+
* Vaults linked when the browser session was created.
512+
*/
513+
vaults?: Array<BrowsersAPI.VaultReference>;
514+
504515
/**
505516
* Initial browser window size in pixels with optional refresh rate. If omitted,
506517
* image defaults apply (1920x1080@25). For GPU images, the default is

src/resources/browsers/browsers.ts

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -479,6 +479,15 @@ export interface Profile {
479479
*/
480480
export type Tags = { [key: string]: string };
481481

482+
/**
483+
* Reference to a project-scoped vault. Provide exactly one of id or name.
484+
*/
485+
export interface VaultReference {
486+
id?: string;
487+
488+
name?: string;
489+
}
490+
482491
export interface BrowserCreateResponse {
483492
/**
484493
* Websocket URL for Chrome DevTools Protocol connections to the browser session
@@ -622,6 +631,17 @@ export interface BrowserCreateResponse {
622631
*/
623632
usage?: BrowserUsage;
624633

634+
/**
635+
* Whether final usage billing is still pending or complete. Only present for
636+
* deleted sessions.
637+
*/
638+
usage_status?: 'pending' | 'ready';
639+
640+
/**
641+
* Vaults linked when the browser session was created.
642+
*/
643+
vaults?: Array<VaultReference>;
644+
625645
/**
626646
* Initial browser window size in pixels with optional refresh rate. If omitted,
627647
* image defaults apply (1920x1080@25). For GPU images, the default is
@@ -782,6 +802,17 @@ export interface BrowserRetrieveResponse {
782802
*/
783803
usage?: BrowserUsage;
784804

805+
/**
806+
* Whether final usage billing is still pending or complete. Only present for
807+
* deleted sessions.
808+
*/
809+
usage_status?: 'pending' | 'ready';
810+
811+
/**
812+
* Vaults linked when the browser session was created.
813+
*/
814+
vaults?: Array<VaultReference>;
815+
785816
/**
786817
* Initial browser window size in pixels with optional refresh rate. If omitted,
787818
* image defaults apply (1920x1080@25). For GPU images, the default is
@@ -942,6 +973,17 @@ export interface BrowserUpdateResponse {
942973
*/
943974
usage?: BrowserUsage;
944975

976+
/**
977+
* Whether final usage billing is still pending or complete. Only present for
978+
* deleted sessions.
979+
*/
980+
usage_status?: 'pending' | 'ready';
981+
982+
/**
983+
* Vaults linked when the browser session was created.
984+
*/
985+
vaults?: Array<VaultReference>;
986+
945987
/**
946988
* Initial browser window size in pixels with optional refresh rate. If omitted,
947989
* image defaults apply (1920x1080@25). For GPU images, the default is
@@ -1102,6 +1144,17 @@ export interface BrowserListResponse {
11021144
*/
11031145
usage?: BrowserUsage;
11041146

1147+
/**
1148+
* Whether final usage billing is still pending or complete. Only present for
1149+
* deleted sessions.
1150+
*/
1151+
usage_status?: 'pending' | 'ready';
1152+
1153+
/**
1154+
* Vaults linked when the browser session was created.
1155+
*/
1156+
vaults?: Array<VaultReference>;
1157+
11051158
/**
11061159
* Initial browser window size in pixels with optional refresh rate. If omitted,
11071160
* image defaults apply (1920x1080@25). For GPU images, the default is
@@ -1270,6 +1323,12 @@ export interface BrowserCreateParams {
12701323
*/
12711324
timeout_seconds?: number;
12721325

1326+
/**
1327+
* Project-scoped vaults to link to the browser session. Links are immutable after
1328+
* creation.
1329+
*/
1330+
vaults?: Array<VaultReference>;
1331+
12731332
/**
12741333
* Initial browser window size in pixels with optional refresh rate. If omitted,
12751334
* image defaults apply (1920x1080@25). For GPU images, the default is
@@ -1657,6 +1716,7 @@ export declare namespace Browsers {
16571716
type BrowserUsage as BrowserUsage,
16581717
type Profile as Profile,
16591718
type Tags as Tags,
1719+
type VaultReference as VaultReference,
16601720
type BrowserCreateResponse as BrowserCreateResponse,
16611721
type BrowserRetrieveResponse as BrowserRetrieveResponse,
16621722
type BrowserUpdateResponse as BrowserUpdateResponse,

src/resources/browsers/index.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ export {
1212
type BrowserUsage,
1313
type Profile,
1414
type Tags,
15+
type VaultReference,
1516
type BrowserCreateResponse,
1617
type BrowserRetrieveResponse,
1718
type BrowserUpdateResponse,

src/resources/config-registry/config-registry.ts

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,8 @@ export class ConfigRegistry extends APIResource {
1515
analyses: AnalysesAPI.Analyses = new AnalysesAPI.Analyses(this._client);
1616

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

432432
export interface RecommendationSummary {
433433
/**
434-
* ID of the most recently requested analysis for this domain.
434+
* ID of the most recently requested analysis for this exact target.
435435
*/
436436
analysis_id: string;
437437

438438
/**
439-
* Lifecycle status of the most recently requested analysis for this domain.
439+
* Lifecycle status of the most recently requested analysis for this exact target.
440440
*/
441441
analysis_status: 'running' | 'completed' | 'failed' | 'canceled';
442442

443443
/**
444-
* Most recent time the selected project requested an analysis for this domain.
444+
* Most recent time the selected project requested an analysis for this exact
445+
* target.
445446
*/
446447
last_requested_at: string;
447448

448449
/**
449-
* Current domain-level recommendation. Null when no eligible knowledge exists.
450+
* Recommendation produced by the latest analysis. Null when that analysis did not
451+
* produce one.
450452
*/
451453
recommendation: Recommendation | null;
452454

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

458460
/**
459-
* Success rate for the recommended configuration. Null when no eligible knowledge
460-
* exists.
461+
* Success rate for the recommended configuration. Null when the latest analysis
462+
* did not produce one.
461463
*/
462464
success_rate: number | null;
463465

464466
/**
465-
* Registrable domain previously analyzed by the selected project.
467+
* Normalized exact target previously analyzed by the selected project, including
468+
* scheme, host, port, and path.
466469
*/
467470
target: string;
468471
}
@@ -500,8 +503,8 @@ export interface Target {
500503

501504
export interface ConfigRegistryListParams extends OffsetPaginationParams {
502505
/**
503-
* Case-insensitive domain search. Full URLs are reduced to their registrable
504-
* domain.
506+
* Case-insensitive substring search over normalized targets, including domain,
507+
* subdomain, and path.
505508
*/
506509
search?: string;
507510

0 commit comments

Comments
 (0)