Starstruk Logo MarkStarstruk

js/sandbox/v0.1.9

opensandbox-group/OpenSandboxjs/sandbox/v0.1.9Jun 16, 2026by ninan-nn

AI Summary

JavaScript SDK update adds resource requests, line-based file reading, and credential vault support. It also fixes background log tails and regenerates API types from spec updates.

Key Highlights

  • Added resourceRequests for Kubernetes-backed sandboxes to separate requests from limits
  • Added line-based file reads to read slices of large text files without downloading the full file
  • Added directory listing support with depth-controlled traversal and symlink handling
  • Added detailed replace-content feedback without breaking existing callers
  • Added Credential Vault support including multi-language E2E coverage

New Features

  • resourceRequests field in sandbox creation
  • Line-based file reads with offset and limit
  • Directory listing
  • Detailed replace-content feedback
  • Credential Vault support

Full Release Notes

## What's New

### Features

- Added `resourceRequests` to sandbox creation so Kubernetes-backed sandboxes can set resource requests separately from limits. Omitting the field preserves the existing behavior where requests match limits.
- Added line-based file reads through `GET /files/download` with `offset` and `limit` query parameters. This lets SDK callers read slices of large text files without downloading the full file.
- Added directory listing support through the new execd directory API. The SDK now exposes depth-controlled traversal and file entry types, while symlinks are reported as symlinks and are not recursively traversed. https://github.com/opensandbox-group/OpenSandbox/pull/1001
- Added detailed replace-content feedback without breaking existing callers. Existing replace methods keep their original no-return behavior, while new detailed methods opt in to per-file `replacedCount` results so callers can detect no-match and multi-match replacements. https://github.com/opensandbox-group/OpenSandbox/pull/991
- Added Credential Vault support to the JavaScript SDK surface, including SDK model coverage and multi-language E2E coverage for credential injection flows. https://github.com/opensandbox-group/OpenSandbox/pull/1009 https://github.com/opensandbox-group/OpenSandbox/pull/1023

### Bug Fixes

- Background log tails with an empty response body are now accepted instead of being treated as malformed output.
- Regenerated JavaScript execd API types from the latest spec updates, including the line-read and replace-content API changes.

### Misc

- Bumped the JavaScript Sandbox SDK package version to `0.1.9`.

### Contributors

- @Pangjiping
- @asiudgufgbukbsa
- @jwx0925
- @ninan-nn