Merge pull request #63 from kernel/release-please--branches--main--changes--next--components--sdk

release: 0.25.0

Author: masnwilliams

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.24.0"
+  ".": "0.25.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 89
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-13214b99e392aab631aa1ca99b6a51a58df81e34156d21b8d639bea779566123.yml
-openapi_spec_hash: a88d175fc3980de3097ac1411d8dcbff
-config_hash: 179f33af31ece83563163d5b3d751d13
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-8d66dbedea5b240936b338809f272568ca84a452fc13dbda835479f2ec068b41.yml
+openapi_spec_hash: 7c499bfce2e996f1fff5e7791cea390e
+config_hash: fcc2db3ed48ab4e8d1b588d31d394a23

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.25.0 (2026-01-07)
+
+Full Changelog: [v0.24.0...v0.25.0](https://github.com/onkernel/kernel-node-sdk/compare/v0.24.0...v0.25.0)
+
+### Features
+
+* **api:** add health check endpoint for proxies ([999dfe5](https://github.com/onkernel/kernel-node-sdk/commit/999dfe58dbdfae072207e03d83efea58eb914a32))
+* **auth:** add auto_login credential flow ([3f4eb01](https://github.com/onkernel/kernel-node-sdk/commit/3f4eb01bb73f679828e195a74f41214d69c01453))
+* Enhance AuthAgentInvocation with step and last activity tracking ([8380eb6](https://github.com/onkernel/kernel-node-sdk/commit/8380eb6cef2c8229bee4e263bcd0637f9fcb1480))
+
+
+### Chores
+
+* break long lines in snippets into multiline ([c546f46](https://github.com/onkernel/kernel-node-sdk/commit/c546f46485ea1e853347db59c4abc5d8c9389b6c))
+* **internal:** codegen related update ([00a9097](https://github.com/onkernel/kernel-node-sdk/commit/00a9097ee42022b917f90fa6dd33938a3f1a9866))
+
 ## 0.24.0 (2025-12-17)
 
 Full Changelog: [v0.23.0...v0.24.0](https://github.com/onkernel/kernel-node-sdk/compare/v0.23.0...v0.24.0)

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Kernel
+   Copyright 2026 Kernel
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.md

@@ -163,7 +163,10 @@ You can use the `for await … of` syntax to iterate through items across all pa
 async function fetchAllDeploymentListResponses(params) {
   const allDeploymentListResponses = [];
   // Automatically fetches more pages as needed.
-  for await (const deploymentListResponse of client.deployments.list({ app_name: 'YOUR_APP', limit: 2 })) {
+  for await (const deploymentListResponse of client.deployments.list({
+    app_name: 'YOUR_APP',
+    limit: 2,
+  })) {
     allDeploymentListResponses.push(deploymentListResponse);
   }
   return allDeploymentListResponses;
@@ -203,7 +206,9 @@ const response = await client.browsers.create({ stealth: true }).asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
-const { data: browser, response: raw } = await client.browsers.create({ stealth: true }).withResponse();
+const { data: browser, response: raw } = await client.browsers
+  .create({ stealth: true })
+  .withResponse();
 console.log(raw.headers.get('X-My-Header'));
 console.log(browser.session_id);
 ```

api.md

@@ -201,13 +201,15 @@ Types:
 - <code><a href="./src/resources/proxies.ts">ProxyCreateResponse</a></code>
 - <code><a href="./src/resources/proxies.ts">ProxyRetrieveResponse</a></code>
 - <code><a href="./src/resources/proxies.ts">ProxyListResponse</a></code>
+- <code><a href="./src/resources/proxies.ts">ProxyCheckResponse</a></code>
 
 Methods:
 
 - <code title="post /proxies">client.proxies.<a href="./src/resources/proxies.ts">create</a>({ ...params }) -> ProxyCreateResponse</code>
 - <code title="get /proxies/{id}">client.proxies.<a href="./src/resources/proxies.ts">retrieve</a>(id) -> ProxyRetrieveResponse</code>
 - <code title="get /proxies">client.proxies.<a href="./src/resources/proxies.ts">list</a>() -> ProxyListResponse</code>
 - <code title="delete /proxies/{id}">client.proxies.<a href="./src/resources/proxies.ts">delete</a>(id) -> void</code>
+- <code title="post /proxies/{id}/check">client.proxies.<a href="./src/resources/proxies.ts">check</a>(id) -> ProxyCheckResponse</code>
 
 # Extensions
 
@@ -249,23 +251,20 @@ Methods:
 
 Types:
 
-- <code><a href="./src/resources/agents/auth/auth.ts">AgentAuthDiscoverResponse</a></code>
 - <code><a href="./src/resources/agents/auth/auth.ts">AgentAuthInvocationResponse</a></code>
 - <code><a href="./src/resources/agents/auth/auth.ts">AgentAuthSubmitResponse</a></code>
 - <code><a href="./src/resources/agents/auth/auth.ts">AuthAgent</a></code>
 - <code><a href="./src/resources/agents/auth/auth.ts">AuthAgentCreateRequest</a></code>
 - <code><a href="./src/resources/agents/auth/auth.ts">AuthAgentInvocationCreateRequest</a></code>
 - <code><a href="./src/resources/agents/auth/auth.ts">AuthAgentInvocationCreateResponse</a></code>
 - <code><a href="./src/resources/agents/auth/auth.ts">DiscoveredField</a></code>
-- <code><a href="./src/resources/agents/auth/auth.ts">ReauthResponse</a></code>
 
 Methods:
 
 - <code title="post /agents/auth">client.agents.auth.<a href="./src/resources/agents/auth/auth.ts">create</a>({ ...params }) -> AuthAgent</code>
 - <code title="get /agents/auth/{id}">client.agents.auth.<a href="./src/resources/agents/auth/auth.ts">retrieve</a>(id) -> AuthAgent</code>
 - <code title="get /agents/auth">client.agents.auth.<a href="./src/resources/agents/auth/auth.ts">list</a>({ ...params }) -> AuthAgentsOffsetPagination</code>
 - <code title="delete /agents/auth/{id}">client.agents.auth.<a href="./src/resources/agents/auth/auth.ts">delete</a>(id) -> void</code>
-- <code title="post /agents/auth/{id}/reauth">client.agents.auth.<a href="./src/resources/agents/auth/auth.ts">reauth</a>(id) -> ReauthResponse</code>
 
 ### Invocations
 
@@ -277,7 +276,6 @@ Methods:
 
 - <code title="post /agents/auth/invocations">client.agents.auth.invocations.<a href="./src/resources/agents/auth/invocations.ts">create</a>({ ...params }) -> AuthAgentInvocationCreateResponse</code>
 - <code title="get /agents/auth/invocations/{invocation_id}">client.agents.auth.invocations.<a href="./src/resources/agents/auth/invocations.ts">retrieve</a>(invocationID) -> AgentAuthInvocationResponse</code>
-- <code title="post /agents/auth/invocations/{invocation_id}/discover">client.agents.auth.invocations.<a href="./src/resources/agents/auth/invocations.ts">discover</a>(invocationID, { ...params }) -> AgentAuthDiscoverResponse</code>
 - <code title="post /agents/auth/invocations/{invocation_id}/exchange">client.agents.auth.invocations.<a href="./src/resources/agents/auth/invocations.ts">exchange</a>(invocationID, { ...params }) -> InvocationExchangeResponse</code>
 - <code title="post /agents/auth/invocations/{invocation_id}/submit">client.agents.auth.invocations.<a href="./src/resources/agents/auth/invocations.ts">submit</a>(invocationID, { ...params }) -> AgentAuthSubmitResponse</code>
 
@@ -288,11 +286,13 @@ Types:
 - <code><a href="./src/resources/credentials.ts">CreateCredentialRequest</a></code>
 - <code><a href="./src/resources/credentials.ts">Credential</a></code>
 - <code><a href="./src/resources/credentials.ts">UpdateCredentialRequest</a></code>
+- <code><a href="./src/resources/credentials.ts">CredentialTotpCodeResponse</a></code>
 
 Methods:
 
 - <code title="post /credentials">client.credentials.<a href="./src/resources/credentials.ts">create</a>({ ...params }) -> Credential</code>
-- <code title="get /credentials/{id}">client.credentials.<a href="./src/resources/credentials.ts">retrieve</a>(id) -> Credential</code>
-- <code title="patch /credentials/{id}">client.credentials.<a href="./src/resources/credentials.ts">update</a>(id, { ...params }) -> Credential</code>
+- <code title="get /credentials/{id_or_name}">client.credentials.<a href="./src/resources/credentials.ts">retrieve</a>(idOrName) -> Credential</code>
+- <code title="patch /credentials/{id_or_name}">client.credentials.<a href="./src/resources/credentials.ts">update</a>(idOrName, { ...params }) -> Credential</code>
 - <code title="get /credentials">client.credentials.<a href="./src/resources/credentials.ts">list</a>({ ...params }) -> CredentialsOffsetPagination</code>
-- <code title="delete /credentials/{id}">client.credentials.<a href="./src/resources/credentials.ts">delete</a>(id) -> void</code>
+- <code title="delete /credentials/{id_or_name}">client.credentials.<a href="./src/resources/credentials.ts">delete</a>(idOrName) -> void</code>
+- <code title="get /credentials/{id_or_name}/totp-code">client.credentials.<a href="./src/resources/credentials.ts">totpCode</a>(idOrName) -> CredentialTotpCodeResponse</code>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onkernel/sdk",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "The official TypeScript library for the Kernel API",
   "author": "Kernel <>",
   "types": "dist/index.d.ts",

src/client.ts

@@ -35,6 +35,7 @@ import {
   Credential,
   CredentialCreateParams,
   CredentialListParams,
+  CredentialTotpCodeResponse,
   CredentialUpdateParams,
   Credentials,
   CredentialsOffsetPagination,
@@ -77,6 +78,7 @@ import {
 import { ProfileCreateParams, ProfileListResponse, Profiles } from './resources/profiles';
 import {
   Proxies,
+  ProxyCheckResponse,
   ProxyCreateParams,
   ProxyCreateResponse,
   ProxyListResponse,
@@ -950,6 +952,7 @@ export declare namespace Kernel {
     type ProxyCreateResponse as ProxyCreateResponse,
     type ProxyRetrieveResponse as ProxyRetrieveResponse,
     type ProxyListResponse as ProxyListResponse,
+    type ProxyCheckResponse as ProxyCheckResponse,
     type ProxyCreateParams as ProxyCreateParams,
   };
 
@@ -980,6 +983,7 @@ export declare namespace Kernel {
     type CreateCredentialRequest as CreateCredentialRequest,
     type Credential as Credential,
     type UpdateCredentialRequest as UpdateCredentialRequest,
+    type CredentialTotpCodeResponse as CredentialTotpCodeResponse,
     type CredentialsOffsetPagination as CredentialsOffsetPagination,
     type CredentialCreateParams as CredentialCreateParams,
     type CredentialUpdateParams as CredentialUpdateParams,

src/resources/agents/agents.ts

@@ -3,7 +3,6 @@
 import { APIResource } from '../../core/resource';
 import * as AuthAPI from './auth/auth';
 import {
-  AgentAuthDiscoverResponse,
   AgentAuthInvocationResponse,
   AgentAuthSubmitResponse,
   Auth,
@@ -15,7 +14,6 @@ import {
   AuthCreateParams,
   AuthListParams,
   DiscoveredField,
-  ReauthResponse,
 } from './auth/auth';
 
 export class Agents extends APIResource {
@@ -27,15 +25,13 @@ Agents.Auth = Auth;
 export declare namespace Agents {
   export {
     Auth as Auth,
-    type AgentAuthDiscoverResponse as AgentAuthDiscoverResponse,
     type AgentAuthInvocationResponse as AgentAuthInvocationResponse,
     type AgentAuthSubmitResponse as AgentAuthSubmitResponse,
     type AuthAgent as AuthAgent,
     type AuthAgentCreateRequest as AuthAgentCreateRequest,
     type AuthAgentInvocationCreateRequest as AuthAgentInvocationCreateRequest,
     type AuthAgentInvocationCreateResponse as AuthAgentInvocationCreateResponse,
     type DiscoveredField as DiscoveredField,
-    type ReauthResponse as ReauthResponse,
     type AuthAgentsOffsetPagination as AuthAgentsOffsetPagination,
     type AuthCreateParams as AuthCreateParams,
     type AuthListParams as AuthListParams,