kern-sandbox 0.2.17 → 0.2.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +6 -6
  2. package/index.js +1 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,11 +1,11 @@
1
1
  # kern-sandbox (Node.js / TypeScript)
2
2
 
3
- **Run AI-generated code in a real sandbox, one fresh box per call, in about 4 ms.**
3
+ **Run AI-generated code in a fast, real sandbox, one fresh box per call.**
4
4
 
5
- That 4 ms is the BOX. A trivial `run_code` costs more, because an interpreter has to start
6
- inside it: about 16 ms for Python on the machine this was measured on, of which ~12 is CPython
7
- itself (a bare `python3 -c` on the host already costs ~8). The two numbers answer two different
8
- questions, and quoting one where the other belongs is how a benchmark becomes a lie.
5
+ Fast means milliseconds, and it is two numbers rather than one: the box is the cheap part, and an
6
+ interpreter starting inside it costs more than the box does. Both depend on your machine, so they are
7
+ measured under [Prewarming](#prewarming-a-box-ready-before-the-call-arrives) with the machine and the method beside them, and the
8
+ runtime's own are in [BENCHMARKS.md](https://github.com/getkern/kern/blob/main/BENCHMARKS.md).
9
9
 
10
10
  `kern-sandbox` is the Node and TypeScript binding for **[kern](https://getkern.dev)**: a rootless,
11
11
  kernel-enforced sandbox out of one static binary, with no daemon, no VM and no cloud. An agent's
@@ -23,7 +23,7 @@ agent branches on a value instead of parsing text to work out who ended the run.
23
23
 
24
24
  On npm: [`npm install kern-sandbox`](https://www.npmjs.com/package/kern-sandbox). Python gets the same
25
25
  package on PyPI: [`kern-sandbox`](https://pypi.org/project/kern-sandbox/), which also ships an **MCP
26
- server** for Claude Desktop and Cursor.
26
+ server** for Claude Desktop, Cursor and LM Studio.
27
27
 
28
28
  ```js
29
29
  const kern = require("kern-sandbox");
package/index.js CHANGED
@@ -36,7 +36,7 @@ const crypto = require("crypto");
36
36
  const zlib = require("zlib");
37
37
  const { spawn, spawnSync } = require("child_process");
38
38
 
39
- const VERSION = "0.2.17";
39
+ const VERSION = "0.2.19";
40
40
 
41
41
  const DEFAULT_IMAGE = "python:3.12-slim";
42
42
  const WORKSPACE = "/workspace"; // where the persistent workspace is mounted inside every box
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "kern-sandbox",
3
- "version": "0.2.17",
3
+ "version": "0.2.19",
4
4
  "description": "kern is a fast, rootless sandbox and virtual resource runtime for any workload, including untrusted and AI-generated code; kern-sandbox is its Node/TypeScript binding. Run untrusted or agent-generated code (Python/JS/Bash) in a real, kernel-enforced box in single-digit milliseconds, with no cloud, no account and no VM.",
5
5
  "keywords": [
6
6
  "sandbox",