Merge branch 'main' into fix/update-org-name-in-workflows

Author: masnwilliams

.github/workflows/release-doctor.yml

@@ -19,3 +19,4 @@ jobs:
           bash ./bin/check-release-environment
         env:
           NPM_TOKEN: ${{ secrets.KERNEL_NPM_TOKEN || secrets.NPM_TOKEN }}
+

.gitignore

@@ -7,3 +7,4 @@ dist
 dist-deno
 /*.tgz
 .idea/
+.eslintcache

.release-please-manifest.json

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

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-3ec96d0022acb32aa2676c2e7ae20152b899a776ccd499380c334c955b9ba071.yml
-openapi_spec_hash: b64c095d82185c1cd0355abea88b606f
-config_hash: 00ec9df250b9dc077f8d3b93a442d252
+configured_endpoints: 89
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-8d66dbedea5b240936b338809f272568ca84a452fc13dbda835479f2ec068b41.yml
+openapi_spec_hash: 7c499bfce2e996f1fff5e7791cea390e
+config_hash: fcc2db3ed48ab4e8d1b588d31d394a23

CHANGELOG.md

@@ -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.

LICENSE

@@ -27,14 +27,9 @@ const client = new Kernel({
   environment: 'development', // defaults to 'production'
 });
 
-const deployment = await client.apps.deployments.create({
-  entrypoint_rel_path: 'main.ts',
-  file: fs.createReadStream('path/to/file'),
-  env_vars: { OPENAI_API_KEY: 'x' },
-  version: '1.0.0',
-});
+const browser = await client.browsers.create({ stealth: true });
 
-console.log(deployment.apps);
+console.log(browser.session_id);
 ```
 
 ### Request & Response types
@@ -50,10 +45,7 @@ const client = new Kernel({
   environment: 'development', // defaults to 'production'
 });
 
-const params: Kernel.BrowserCreateParams = {
-  invocation_id: 'REPLACE_ME',
-  persistence: { id: 'browser-for-user-1234' },
-};
+const params: Kernel.BrowserCreateParams = { stealth: true };
 const browser: Kernel.BrowserCreateResponse = await client.browsers.create(params);
 ```
 
@@ -75,32 +67,17 @@ import Kernel, { toFile } from '@onkernel/sdk';
 const client = new Kernel();
 
 // If you have access to Node `fs` we recommend using `fs.createReadStream()`:
-await client.apps.deployments.create({
-  entrypoint_rel_path: 'src/app.py',
-  file: fs.createReadStream('/path/to/file'),
-});
+await client.deployments.create({ file: fs.createReadStream('/path/to/file') });
 
 // Or if you have the web `File` API you can pass a `File` instance:
-await client.apps.deployments.create({
-  entrypoint_rel_path: 'src/app.py',
-  file: new File(['my bytes'], 'file'),
-});
+await client.deployments.create({ file: new File(['my bytes'], 'file') });
 
 // You can also pass a `fetch` `Response`:
-await client.apps.deployments.create({
-  entrypoint_rel_path: 'src/app.py',
-  file: await fetch('https://somesite/file'),
-});
+await client.deployments.create({ file: await fetch('https://somesite/file') });
 
 // Finally, if none of the above are convenient, you can use our `toFile` helper:
-await client.apps.deployments.create({
-  entrypoint_rel_path: 'src/app.py',
-  file: await toFile(Buffer.from('my bytes'), 'file'),
-});
-await client.apps.deployments.create({
-  entrypoint_rel_path: 'src/app.py',
-  file: await toFile(new Uint8Array([0, 1, 2]), 'file'),
-});
+await client.deployments.create({ file: await toFile(Buffer.from('my bytes'), 'file') });
+await client.deployments.create({ file: await toFile(new Uint8Array([0, 1, 2]), 'file') });
 ```
 
 ## Handling errors
@@ -111,17 +88,15 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const browser = await client.browsers
-  .create({ invocation_id: 'REPLACE_ME', persistence: { id: 'browser-for-user-1234' } })
-  .catch(async (err) => {
-    if (err instanceof Kernel.APIError) {
-      console.log(err.status); // 400
-      console.log(err.name); // BadRequestError
-      console.log(err.headers); // {server: 'nginx', ...}
-    } else {
-      throw err;
-    }
-  });
+const browser = await client.browsers.create({ stealth: true }).catch(async (err) => {
+  if (err instanceof Kernel.APIError) {
+    console.log(err.status); // 400
+    console.log(err.name); // BadRequestError
+    console.log(err.headers); // {server: 'nginx', ...}
+  } else {
+    throw err;
+  }
+});
 ```
 
 Error codes are as follows:
@@ -153,7 +128,7 @@ const client = new Kernel({
 });
 
 // Or, configure per-request:
-await client.browsers.create({ invocation_id: 'REPLACE_ME', persistence: { id: 'browser-for-user-1234' } }, {
+await client.browsers.create({ stealth: true }, {
   maxRetries: 5,
 });
 ```
@@ -170,7 +145,7 @@ const client = new Kernel({
 });
 
 // Override per-request:
-await client.browsers.create({ invocation_id: 'REPLACE_ME', persistence: { id: 'browser-for-user-1234' } }, {
+await client.browsers.create({ stealth: true }, {
   timeout: 5 * 1000,
 });
 ```
@@ -179,6 +154,40 @@ On timeout, an `APIConnectionTimeoutError` is thrown.
 
 Note that requests which time out will be [retried twice by default](#retries).
 
+## Auto-pagination
+
+List methods in the Kernel API are paginated.
+You can use the `for await … of` syntax to iterate through items across all pages:
+
+```ts
+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,
+  })) {
+    allDeploymentListResponses.push(deploymentListResponse);
+  }
+  return allDeploymentListResponses;
+}
+```
+
+Alternatively, you can request a single page at a time:
+
+```ts
+let page = await client.deployments.list({ app_name: 'YOUR_APP', limit: 2 });
+for (const deploymentListResponse of page.items) {
+  console.log(deploymentListResponse);
+}
+
+// Convenience methods are provided for manually paginating:
+while (page.hasNextPage()) {
+  page = await page.getNextPage();
+  // ...
+}
+```
+
 ## Advanced Usage
 
 ### Accessing raw Response data (e.g., headers)
@@ -193,14 +202,12 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 ```ts
 const client = new Kernel();
 
-const response = await client.browsers
-  .create({ invocation_id: 'REPLACE_ME', persistence: { id: 'browser-for-user-1234' } })
-  .asResponse();
+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({ invocation_id: 'REPLACE_ME', persistence: { id: 'browser-for-user-1234' } })
+  .create({ stealth: true })
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));
 console.log(browser.session_id);
@@ -283,7 +290,7 @@ parameter. This library doesn't validate at runtime that the request matches the
 send will be sent as-is.
 
 ```ts
-client.apps.deployments.create({
+client.browsers.create({
   // ...
   // @ts-expect-error baz is not yet public
   baz: 'undocumented option',