wbxsandbox 0.1.2 → 0.1.3
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.
- package/CHANGELOG.md +7 -0
- package/README.md +38 -9
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
- package/src/version.ts +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,13 @@ All notable changes to this package are documented here. The format follows
|
|
|
4
4
|
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the package uses
|
|
5
5
|
[semantic versioning](https://semver.org) (while 0.x, minor releases may break compatibility).
|
|
6
6
|
|
|
7
|
+
## [0.1.3] – 2026-11-20
|
|
8
|
+
|
|
9
|
+
### Documentation
|
|
10
|
+
|
|
11
|
+
- README: overview of what the SDK covers (sandboxes, jobs, batches, metrics, desktop, receipts, webhooks,
|
|
12
|
+
budgets) with links to the documentation. No code changes.
|
|
13
|
+
|
|
7
14
|
## [0.1.2] – 2026-11-20
|
|
8
15
|
|
|
9
16
|
### Fixed
|
package/README.md
CHANGED
|
@@ -1,17 +1,46 @@
|
|
|
1
1
|
# wbxsandbox – TypeScript SDK for WBX Sandbox
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
sandboxes for AI agents and code execution. Every sandbox is a Firecracker microVM with its own
|
|
5
|
-
Linux kernel, disk and network rules.
|
|
3
|
+
[](https://www.npmjs.com/package/wbxsandbox)
|
|
6
4
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
5
|
+
The official TypeScript / JavaScript SDK for [WBX Sandbox](https://sandbox.wbx.cz) – give your
|
|
6
|
+
AI agent a computer of its own. Every sandbox is an isolated Linux microVM (Firecracker) with its
|
|
7
|
+
own kernel, disk, processes and network rules, running on servers in the EU. Your agent runs
|
|
8
|
+
code, installs packages, serves web apps and works with files there – never on your machine.
|
|
9
|
+
|
|
10
|
+
**Zero runtime dependencies** – only `fetch`, `ReadableStream` and Web Crypto. Runs on Node.js
|
|
11
|
+
20+, Deno, Bun and edge runtimes.
|
|
12
|
+
|
|
13
|
+
```ts
|
|
14
|
+
import { WBX } from "wbxsandbox";
|
|
15
|
+
|
|
16
|
+
const wbx = new WBX(); // API key from WBXSANDBOX_API_KEY
|
|
17
|
+
const sandbox = await wbx.sandboxes.create({ template: "base" });
|
|
18
|
+
const r = await sandbox.commands.run("python3 -c 'print(6 * 7)'");
|
|
19
|
+
console.log(r.exitCode, r.stdout); // 0 "42\n"
|
|
20
|
+
await sandbox.kill();
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## What it covers
|
|
24
|
+
|
|
25
|
+
| Area | | Docs |
|
|
26
|
+
|---|---|---|
|
|
27
|
+
| **Sandboxes** | Create, attach later, list, extend, pause / resume, destroy; templates, environment, labels, compute class | [Create and manage](https://sandbox.wbx.cz/docs/sandboxes) |
|
|
28
|
+
| **Commands and code** | Run and wait, live output callbacks, async-iterator streams, `runCode()` for Python, Node.js and bash | [Commands](https://sandbox.wbx.cz/docs/sandboxes/commands) |
|
|
29
|
+
| **Files and processes** | Read, write, stream, list, move, watch for changes; background processes with stdin, signals and terminals | [Files](https://sandbox.wbx.cz/docs/sandboxes/files) |
|
|
30
|
+
| **Sleep and wake** | Named sandboxes that fall asleep with their files – no compute billed – and wake on the next request | [Sleep and wake](https://sandbox.wbx.cz/docs/sandboxes/sleep) |
|
|
31
|
+
| **Network and public URLs** | No network, allowlists, a public IPv6 address per sandbox; an HTTPS address with a token for any port | [Network](https://sandbox.wbx.cz/docs/sandboxes/network) · [URLs](https://sandbox.wbx.cz/docs/sandboxes/urls) |
|
|
32
|
+
| **Background jobs** | Fire and forget, server-side waiting, log digests for LLMs, SHA-256-checked result files, signed execution receipts, WebAssembly jobs | [Jobs](https://sandbox.wbx.cz/docs/jobs) |
|
|
33
|
+
| **Batches** | Many jobs in one call with a concurrency and total price limit, dependencies and files passed between jobs | [Batches](https://sandbox.wbx.cz/docs/jobs/batches) |
|
|
34
|
+
| **Metrics** | CPU, memory, network and disk measured by the host every 10 s – history and a live stream | [Metrics](https://sandbox.wbx.cz/docs/sandboxes/metrics) |
|
|
35
|
+
| **Desktop & Computer Use** (beta) | Screenshots, mouse and keyboard on a Linux desktop; enabled per team on request | [Desktop](https://sandbox.wbx.cz/docs/sandboxes/desktop) |
|
|
36
|
+
| **Account** | Templates, enabled features, budgets, compute classes, webhook secret and verification | [Budgets](https://sandbox.wbx.cz/docs/jobs/budget) · [Webhooks](https://sandbox.wbx.cz/docs/jobs/webhooks) |
|
|
37
|
+
|
|
38
|
+
Built for production code: typed errors with `status`, `code` and `retryAfter`, timeouts and
|
|
39
|
+
`AbortSignal` on every call, automatic retries only for requests that cannot take effect twice,
|
|
40
|
+
and an API key that never shows up in logs.
|
|
13
41
|
|
|
14
42
|
> **Status:** 0.x – see [Versioning and compatibility](#versioning-and-compatibility).
|
|
43
|
+
> Pricing: https://sandbox.wbx.cz/pricing
|
|
15
44
|
|
|
16
45
|
## Contents
|
|
17
46
|
|
package/dist/version.d.ts
CHANGED
package/dist/version.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "wbxsandbox",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"description": "Official TypeScript SDK for WBX Sandbox – isolated cloud sandboxes (Firecracker microVMs) for AI agents: commands, files, background jobs, batches, metrics and desktop control",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "WBX Sandbox",
|
package/src/version.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
/** Version of this SDK (kept equal to `version` in package.json – checked by the tests). */
|
|
2
|
-
export const VERSION = "0.1.
|
|
2
|
+
export const VERSION = "0.1.3";
|