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 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
- Official TypeScript / JavaScript SDK for [WBX Sandbox](https://sandbox.wbx.cz): isolated cloud
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
+ [![npm](https://img.shields.io/npm/v/wbxsandbox)](https://www.npmjs.com/package/wbxsandbox)
6
4
 
7
- - Sandboxes: commands (also streamed), code, files, background processes, public URLs, sleep and wake
8
- - Background jobs and batches: no open connection, logs, result files, signed execution receipts
9
- - Live metrics and desktop control (computer use) for agents
10
- - Typed errors, timeouts, `AbortSignal` everywhere, safe automatic retries
11
- - Zero runtime dependencies – only `fetch`, `ReadableStream` and Web Crypto; runs on Node.js 20+,
12
- Deno, Bun and edge runtimes
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
@@ -1,3 +1,3 @@
1
1
  /** Version of this SDK (kept equal to `version` in package.json – checked by the tests). */
2
- export declare const VERSION = "0.1.2";
2
+ export declare const VERSION = "0.1.3";
3
3
  //# sourceMappingURL=version.d.ts.map
package/dist/version.js CHANGED
@@ -1,3 +1,3 @@
1
1
  /** Version of this SDK (kept equal to `version` in package.json – checked by the tests). */
2
- export const VERSION = "0.1.2";
2
+ export const VERSION = "0.1.3";
3
3
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "wbxsandbox",
3
- "version": "0.1.2",
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";
2
+ export const VERSION = "0.1.3";