Starstruk Logo MarkStarstruk

java/sandbox/v1.0.13

opensandbox-group/OpenSandboxjava/sandbox/v1.0.13Jun 16, 2026by ninan-nn

AI Summary

Java/Kotlin SDK update introduces resource management features, line-based file reading, and credential vault support. It also fixes bugs related to directory listing and resource requests.

Key Highlights

  • Added resourceRequests for Kubernetes-backed sandboxes to separate requests from limits
  • Added line-based file reads to read large text files by line range 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 to the SDK surface

New Features

  • resourceRequests field in sandbox creation
  • Line-based file reads with offset and limit
  • Directory listing with depth control and symlink support
  • 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. Kotlin/JVM SDK callers can now read large text files by line range without downloading the entire 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 behavior, while 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 Kotlin/JVM SDK surface, including model, adapter, sandbox creation, and E2E coverage. https://github.com/opensandbox-group/OpenSandbox/pull/1009 https://github.com/opensandbox-group/OpenSandbox/pull/1023

### Bug Fixes

- Fixed resourceRequests-related Kotlin SDK test and model coverage.
- Added a Java-friendly directory-listing overload so Java callers do not need to pass an explicit `null` depth. Directory entries are documented as lexically ordered within each directory. https://github.com/opensandbox-group/OpenSandbox/pull/1001
- Fixed replace-content detailed response handling while keeping the original replace API backward-compatible. https://github.com/opensandbox-group/OpenSandbox/pull/991

### Misc

- Bumped the Kotlin/JVM Sandbox SDK package version and default User-Agent to `1.0.13`.

### Contributors

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