@e2e-dev/kernel 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,5 @@
+@e2e-dev/kernel
+Copyright 2026 TesterArmy, Inc.
+
+This product includes software developed at TesterArmy, Inc.
+(https://tester.army).

package/README.md

@@ -0,0 +1,41 @@
+# @e2e-dev/kernel
+
+[Kernel](https://kernel.sh) hosted browsers for [`e2e`](https://www.npmjs.com/package/e2e):
+`web({ browser: kernel() })` runs a web target in Kernel's hosted Chromium.
+
+## Install
+
+```bash
+npm install --save-dev @e2e-dev/kernel @onkernel/sdk
+```
+
+## Usage
+
+```ts title="e2e.config.ts"
+import type { E2EConfig } from 'e2e';
+import { web } from '@e2e-dev/web';
+import { kernel } from '@e2e-dev/kernel';
+
+export default {
+  targets: [{ engine: web({ browser: kernel({ stealth: true }), viewport: null }), app: { url: 'https://staging.example.com' } }],
+  workers: 4,
+} satisfies E2EConfig;
+```
+
+`KERNEL_API_KEY` comes from the run's environment. `kernel(options)` takes
+Kernel's create-browser body as is (`stealth`, `headless`, `timeout_seconds`,
+`profile`, `proxy_id`, `viewport`, `tags`, ...) plus the lease `scope`:
+`worker` (default) is one browser per worker slot for the run, `attempt` a
+fresh browser per test attempt. Every browser is tagged with the run, target,
+and slot, `timeout_seconds` defaults to 600 so Kernel deletes a browser a dead
+worker never released, and each lease logs its live view URL when Kernel
+gives one. On a headed browser, an attempt that records video (`--video`, or
+a test's `video` option) gets a Kernel replay of the browser's screen as its
+`video/replay.mp4`; a headless browser and `replay: false` get the page
+screencast.
+
+Full documentation lives at [e2e.tester.army/docs/integrations/kernel](https://e2e.tester.army/docs/integrations/kernel).
+
+## License
+
+Apache-2.0

package/dist/.build.json

@@ -0,0 +1 @@
+{"version":"0.1.0"}

package/dist/client.d.ts

@@ -0,0 +1,32 @@
+/** The slice of the Kernel SDK the provider uses, loaded on first use so a config load never pays for it. */
+import type { Kernel } from '@onkernel/sdk';
+/** Kernel's create-browser body, its tags read-only. */
+export type KernelBrowserParams = Omit<Kernel.BrowserCreateParams, 'tags'> & {
+    readonly tags?: Readonly<Record<string, string>> | undefined;
+};
+/** Kernel's start-replay body: `framerate`, `max_duration_in_seconds`, `record_audio`. */
+export type KernelReplayParams = Kernel.Browsers.ReplayStartParams;
+interface KernelBrowser {
+    readonly sessionId: string;
+    readonly cdpWsUrl: string;
+    readonly liveViewUrl?: string | undefined;
+}
+export interface KernelBrowsers {
+    create(params: KernelBrowserParams, signal: AbortSignal): Promise<KernelBrowser>;
+    /** Deletes the browser; one Kernel no longer knows counts as deleted. Resolves to whether Kernel still knew it. */
+    delete(sessionId: string, signal: AbortSignal): Promise<boolean>;
+    /** The session ids of the active browsers carrying every one of `tags`. */
+    listActive(tags: Readonly<Record<string, string>>, signal: AbortSignal): Promise<string[]>;
+    /** Starts recording the browser's screen; resolves to the replay id. */
+    startReplay(sessionId: string, params: KernelReplayParams, signal: AbortSignal): Promise<string>;
+    /** Stops a recording. */
+    stopReplay(sessionId: string, replayId: string, signal: AbortSignal): Promise<void>;
+    /** Downloads a stopped recording's MP4 to `file`. */
+    downloadReplay(sessionId: string, replayId: string, file: string, signal: AbortSignal): Promise<void>;
+    /** The bytes of one file on the browser's own disk. */
+    readFile(sessionId: string, file: string, signal: AbortSignal): Promise<Uint8Array>;
+}
+/** Kernel browsers for one API key, through the SDK. */
+export declare function kernelBrowsers(apiKey: string): KernelBrowsers;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAK7G,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,wDAAwD;AACxD,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,GAAG;IAC3E,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CAC9D,CAAC;AAEF,0FAA0F;AAC1F,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC;AAEnE,UAAU,aAAa;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjF,mHAAmH;IACnH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,2EAA2E;IAC3E,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3F,wEAAwE;IACxE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjG,yBAAyB;IACzB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,qDAAqD;IACrD,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtG,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACrF;AAqBD,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAoD7D"}

package/dist/client.js

@@ -0,0 +1,75 @@
+/** The slice of the Kernel SDK the provider uses, loaded on first use so a config load never pays for it. */
+import { createWriteStream } from 'node:fs';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+/**
+ * An SDK error with its message trimmed: Kernel's error bodies end in a
+ * newline the SDK keeps (`401 Invalid or disabled API key\n`), which would
+ * split the run's error line. The error itself is kept, class and all.
+ */
+function trimmed(cause) {
+    if (cause instanceof Error && cause.message !== cause.message.trim())
+        cause.message = cause.message.trim();
+    return cause;
+}
+/** Runs one SDK request, its failure's message trimmed. */
+async function request(run) {
+    try {
+        return await run();
+    }
+    catch (cause) {
+        throw trimmed(cause);
+    }
+}
+/** Kernel browsers for one API key, through the SDK. */
+export function kernelBrowsers(apiKey) {
+    const sdk = import('@onkernel/sdk').then((module) => ({ client: new module.Kernel({ apiKey }), NotFoundError: module.NotFoundError }));
+    return {
+        create: (params, signal) => request(async () => {
+            const { client } = await sdk;
+            const created = await client.browsers.create({ ...params, tags: { ...params.tags } }, { signal });
+            return { sessionId: created.session_id, cdpWsUrl: created.cdp_ws_url, liveViewUrl: created.browser_live_view_url };
+        }),
+        delete: (sessionId, signal) => request(async () => {
+            const { client, NotFoundError } = await sdk;
+            try {
+                await client.browsers.deleteByID(sessionId, { signal });
+                return true;
+            }
+            catch (cause) {
+                if (!(cause instanceof NotFoundError))
+                    throw cause;
+                return false;
+            }
+        }),
+        listActive: (tags, signal) => request(async () => {
+            const { client } = await sdk;
+            const ids = [];
+            for await (const browser of client.browsers.list({ status: 'active', tags: { ...tags } }, { signal }))
+                ids.push(browser.session_id);
+            return ids;
+        }),
+        startReplay: (sessionId, params, signal) => request(async () => {
+            const { client } = await sdk;
+            const replay = await client.browsers.replays.start(sessionId, params, { signal });
+            return replay.replay_id;
+        }),
+        stopReplay: (sessionId, replayId, signal) => request(async () => {
+            const { client } = await sdk;
+            await client.browsers.replays.stop(replayId, { id_or_name: sessionId }, { signal });
+        }),
+        downloadReplay: (sessionId, replayId, file, signal) => request(async () => {
+            const { client } = await sdk;
+            const response = await client.browsers.replays.download(replayId, { id_or_name: sessionId }, { signal });
+            if (response.body === null)
+                throw new Error(`replay ${replayId} downloaded empty`);
+            await pipeline(Readable.fromWeb(response.body), createWriteStream(file), { signal });
+        }),
+        readFile: (sessionId, file, signal) => request(async () => {
+            const { client } = await sdk;
+            const response = await client.browsers.fs.readFile(sessionId, { path: file }, { signal });
+            return new Uint8Array(await response.arrayBuffer());
+        }),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/env.d.ts

@@ -0,0 +1,3 @@
+/** A non-empty variable from the run's environment, trimmed, or `undefined`. */
+export declare function envValue(env: Readonly<Record<string, string | undefined>>, name: string): string | undefined;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5G"}

package/dist/env.js

@@ -0,0 +1,6 @@
+/** A non-empty variable from the run's environment, trimmed, or `undefined`. */
+export function envValue(env, name) {
+    const value = env[name]?.trim();
+    return value === undefined || value === '' ? undefined : value;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAC,GAAiD,EAAE,IAAY;IACtF,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;IAChC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACjE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `@e2e-dev/kernel` public surface: `kernel()`, a browser provider that leases
+ * hosted Chromium from Kernel for `@e2e-dev/web`.
+ */
+export { kernel } from './provider.ts';
+export type { KernelOptions } from './provider.ts';
+export type { KernelBrowserParams, KernelReplayParams } from './client.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * `@e2e-dev/kernel` public surface: `kernel()`, a browser provider that leases
+ * hosted Chromium from Kernel for `@e2e-dev/web`.
+ */
+export { kernel } from './provider.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,36 @@
+/** Kernel's hosted Chromium as a `BrowserProvider` for the web engine. */
+import type { BrowserProvider, BrowserProviderScope } from '@e2e-dev/web';
+import { type KernelBrowserParams, type KernelReplayParams } from './client.ts';
+/**
+ * Kernel's create-browser body (`stealth`, `headless`, `timeout_seconds`,
+ * `profile`, `proxy_id`, `viewport`, `tags`, ...) plus the lease scope the
+ * web engine defines.
+ */
+export interface KernelOptions extends KernelBrowserParams {
+    /**
+     * `worker` (default): one browser per worker slot, leased in `prepare` and
+     * released in `finish`. `attempt`: a fresh browser per test attempt,
+     * reattached after a CDP transport drop; rules out `headers`, `basicAuth`,
+     * and `userAgent`.
+     */
+    readonly scope?: BrowserProviderScope | undefined;
+    /**
+     * How an attempt that records video is recorded. On (the default), or
+     * Kernel's start-replay body (`framerate`, `max_duration_in_seconds`,
+     * `record_audio`): a Kernel replay of the browser's screen, saved as the
+     * attempt's `video/replay.mp4`. `false`: the web engine's screencast of
+     * the page. A headless browser, which Kernel cannot replay, always gets
+     * the screencast.
+     */
+    readonly replay?: boolean | KernelReplayParams | undefined;
+}
+/**
+ * Kernel browsers for `web({ browser: kernel() })`: one hosted Chromium per
+ * worker slot, or per attempt with `scope: 'attempt'`, created when the
+ * engine asks and deleted when it gives the lease back. Every browser is
+ * tagged with the run, target, slot, and attempt, and saves downloads to its
+ * own disk, read back through Kernel's browser filesystem API.
+ * `KERNEL_API_KEY` comes from the run's environment.
+ */
+export declare function kernel(options?: KernelOptions): BrowserProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAG1E,OAAO,KAAK,EAEV,eAAe,EACf,oBAAoB,EAGrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAkB,KAAK,mBAAmB,EAAuB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAWrH;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACxD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAClD;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAAC;CAC5D;AAOD;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,eAAe,CAsFnE"}

package/dist/provider.js

@@ -0,0 +1,105 @@
+/** Kernel's hosted Chromium as a `BrowserProvider` for the web engine. */
+import path from 'node:path';
+import { envValue } from './env.js';
+import { kernelBrowsers } from './client.js';
+const KERNEL_API_KEY = 'KERNEL_API_KEY';
+/**
+ * Kernel terminates a browser idle this long: the backstop for a run that
+ * died before the engine could release or sweep its leases. Kernel's own
+ * default is shorter than a slow suite's gaps between attempts.
+ */
+const DEFAULT_TIMEOUT_SECONDS = 600;
+const REPLAY_FILE = 'replay.mp4';
+/** Where each Kernel browser saves downloads on its own disk, for the engine to read back through the browser filesystem API. */
+const DOWNLOADS_DIR = '/tmp/e2e-downloads';
+/**
+ * Kernel browsers for `web({ browser: kernel() })`: one hosted Chromium per
+ * worker slot, or per attempt with `scope: 'attempt'`, created when the
+ * engine asks and deleted when it gives the lease back. Every browser is
+ * tagged with the run, target, slot, and attempt, and saves downloads to its
+ * own disk, read back through Kernel's browser filesystem API.
+ * `KERNEL_API_KEY` comes from the run's environment.
+ */
+export function kernel(options = {}) {
+    const { scope, replay = true, ...params } = options;
+    const clients = new Map();
+    const clientFor = (env) => {
+        const apiKey = envValue(env, KERNEL_API_KEY);
+        if (apiKey === undefined)
+            throw new Error(`${KERNEL_API_KEY} is not set`);
+        let client = clients.get(apiKey);
+        if (client === undefined) {
+            client = kernelBrowsers(apiKey);
+            clients.set(apiKey, client);
+        }
+        return client;
+    };
+    // Kernel replays headful browsers only; without `record` the engine records the screencast.
+    const replayParams = replay === false || params.headless === true ? undefined : replay === true ? {} : replay;
+    /** Records each attempt as a Kernel replay of the lease's screen, started with `body` and saved as `replay.mp4`. */
+    const replays = (body) => async (lease, context) => {
+        const client = clientFor(context.env);
+        const startedAt = new Date().toISOString();
+        const replayId = await client.startReplay(lease.id, body, context.signal);
+        // A retried stop (the download failed after the replay stopped) downloads again without stopping twice.
+        let stopped = false;
+        return {
+            startedAt,
+            async stop({ dir, signal }) {
+                if (!stopped) {
+                    await client.stopReplay(lease.id, replayId, signal);
+                    stopped = true;
+                }
+                await client.downloadReplay(lease.id, replayId, path.join(dir, REPLAY_FILE), signal);
+                return { file: REPLAY_FILE };
+            },
+        };
+    };
+    return {
+        name: 'kernel',
+        ...(scope === undefined ? {} : { scope }),
+        async acquire(request) {
+            const client = clientFor(request.env);
+            const browser = await client.create({
+                timeout_seconds: DEFAULT_TIMEOUT_SECONDS,
+                ...params,
+                tags: {
+                    ...params.tags,
+                    e2e_run: request.runId,
+                    e2e_target: request.targetName,
+                    e2e_slot: String(request.slot),
+                    ...(request.attemptId === undefined ? {} : { e2e_attempt: request.attemptId }),
+                },
+            }, request.signal);
+            if (request.signal.aborted) {
+                const outcome = await client.delete(browser.sessionId, AbortSignal.timeout(10_000)).then(() => 'deleted', (cause) => `deleting it failed, so Kernel ends it after timeout_seconds: ${cause instanceof Error ? cause.message : String(cause)}`);
+                throw new Error(`browser ${browser.sessionId} arrived after the request was cancelled; ${outcome}`);
+            }
+            request.log(browser.liveViewUrl === undefined ? `browser ${browser.sessionId}` : `browser ${browser.sessionId}, watch at ${browser.liveViewUrl}`);
+            return { id: browser.sessionId, cdpEndpoint: browser.cdpWsUrl };
+        },
+        async release(lease, context) {
+            await clientFor(context.env).delete(lease.id, context.signal);
+        },
+        async sweep(context) {
+            const client = clientFor(context.env);
+            const open = await client.listActive({ e2e_run: context.runId, e2e_target: context.targetName }, context.signal);
+            const settled = await Promise.allSettled(open.map(async (id) => ((await client.delete(id, context.signal)) ? id : undefined)));
+            const deleted = settled.flatMap((result) => (result.status === 'fulfilled' && result.value !== undefined ? [result.value] : []));
+            const failed = open.flatMap((id, index) => {
+                const result = settled[index];
+                return result.status === 'rejected' ? [`${id} (${result.reason instanceof Error ? result.reason.message : String(result.reason)})`] : [];
+            });
+            if (failed.length > 0) {
+                throw new Error(`deleted ${deleted.length === 0 ? 'none' : deleted.join(', ')}; could not delete ${failed.join(', ')}, so Kernel ends it after timeout_seconds`);
+            }
+            return deleted;
+        },
+        downloads: {
+            dir: DOWNLOADS_DIR,
+            read: async (lease, file, context) => clientFor(context.env).readFile(lease.id, file, context.signal),
+        },
+        ...(replayParams === undefined ? {} : { record: replays(replayParams) }),
+    };
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@e2e-dev/kernel",
+  "version": "0.1.0",
+  "description": "Kernel hosted browsers for e2e: run web targets in Kernel's hosted Chromium",
+  "keywords": [
+    "e2e",
+    "testing",
+    "agentic",
+    "end-to-end",
+    "kernel",
+    "hosted-browsers"
+  ],
+  "license": "Apache-2.0",
+  "contributors": [
+    "Oskar Kwaśniewski <oskar@tester.army>",
+    "Szymon Rybczak <szymon@tester.army>"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tester-army/e2e.git",
+    "directory": "packages/kernel"
+  },
+  "bugs": {
+    "url": "https://github.com/tester-army/e2e/issues"
+  },
+  "homepage": "https://github.com/tester-army/e2e/tree/main/packages/kernel#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public",
+    "provenance": false,
+    "tag": "latest"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "NOTICE"
+  ],
+  "peerDependencies": {
+    "@e2e-dev/web": ">=0.11.0 <1",
+    "@onkernel/sdk": ">=0.113.0 <1",
+    "e2e": ">=0.15.0 <1"
+  },
+  "devDependencies": {
+    "@e2e-dev/web": "0.11.0",
+    "@onkernel/sdk": "0.113.0",
+    "@types/node": "26.6.2",
+    "e2e": "0.15.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.1"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc --project tsconfig.build.json && node ../../scripts/stamp-dist.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:unit": "vitest run tests/unit"
+  }
+}