js/sandbox/v0.1.11

pq-yang/MatAnyone2js/sandbox/v0.1.11Jul 24, 2026by ninan-nn

AI Summary

Adds metrics reporting, client IP detection, and isolated session attachment capabilities to the JavaScript Sandbox SDK.

Key Highlights

  • Sandbox create metrics reporting
  • Client IP header detection
  • Attach to isolated sessions for stateless workers

New Features

  • Sandbox create metrics
  • Client IP header detection
  • Attach to isolated sessions
  • UID mode availability checks
  • Exact snapshot name filtering
  • Isolated session bind mounts and listing
  • Security refresh for npm transitive dependencies

Full Release Notes

## What's New

### ✨ Features

- **Sandbox create metrics** — `Sandbox.create` now reports fire-and-forget `sandbox.create` latency events to the lifecycle server. Reporting ignores old-server version skew and can be disabled with `OPENSANDBOX_DISABLE_METRICS=1`. #1307
- **Client IP header** — the SDK now best-effort detects the host intranet IPv4 through Node network interfaces and sends it as `OPEN-SANDBOX-CLIENT-IP`. User-provided headers are never overwritten. #1326
- **Attach to isolated sessions** — `sandbox.isolation.attach(sessionId)` lets stateless workers rebuild a handle for an existing execd isolated session while that in-memory session is still alive. #1295
- **UID mode availability** — isolated session responses now expose per-mode `setpriv` / `userns` availability, and unavailable requested modes fail with `503 NOT_SUPPORTED`. #1320
- **Exact snapshot name filtering** — snapshot listing now supports an exact `name` filter. #1301
- **Isolated session bind mounts and listing** — isolated sessions can now receive explicit bind mounts, and the SDK exposes isolated session listing so callers can inspect active sessions. #1264 #1269
- **Credential Vault placeholder substitutions** — request matching now supports opt-in placeholders for path, query, header, and body surfaces, including passthrough auth bindings. #1251

### 🔒 Security

- Refreshed pnpm overrides and lockfiles for vulnerable npm transitive dependencies, including `brace-expansion`, `js-yaml`, `fast-uri`, and `postcss`. Local `pnpm audit --registry=https://registry.npmjs.org` reported no known vulnerabilities for `sdks` and `tests/javascript` after the update. #1384

### 📦 Misc

- Bumped JavaScript sandbox SDK version and default User-Agent string for this release. #1384

### 👥 Contributors

- @FAUST-BENCHOU
- @Pangjiping
- @jianpingpei
- @jwx0925
- @ninan-nn
- @ruirui6946