Starstruk Logo MarkStarstruk

java/sandbox/v1.0.11

opensandbox-group/OpenSandboxjava/sandbox/v1.0.11May 12, 2026by ninan-nn

AI Summary

The Kotlin SDK updates mirror the Python SDK, adding metadata patch support with delete semantics and stable Diagnostics API support. It also refines the warmup backoff strategy to reduce pressure during create failures.

Key Highlights

  • Sandbox metadata patch support with delete semantics for null values
  • Stable Diagnostics API support
  • Tuned sandbox pool degraded warmup backoff

New Features

  • Sandbox metadata patch support via new metadata patch API
  • Stable Diagnostics API support

Full Release Notes

## What's Changed

### ✨ Features
* Add sandbox metadata patch support to the Kotlin SDK. `Sandbox` and `SandboxManager` can now apply JSON merge-patch updates through the new metadata patch API, including delete semantics for `null` values; the Kotlin SDK uses a handwritten adapter path so those deletes are preserved correctly and returns parsed `SandboxApiException` details with the request ID when the server rejects the request. Server and lifecycle spec support landed alongside the SDK surface. https://github.com/alibaba/OpenSandbox/pull/857 https://github.com/alibaba/OpenSandbox/pull/861 https://github.com/alibaba/OpenSandbox/pull/863

* Add stable Diagnostics API support to the Kotlin SDK. `Sandbox` and `SandboxManager` now expose `getDiagnosticLogs` and `getDiagnosticEvents` with required diagnostic `scope`, plus domain models, converters, adapter wiring, and tests. Existing legacy DevOps clients are not broken, but the stable Diagnostics API currently returns `DIAGNOSTICS_NOT_IMPLEMENTED` from the open-source server until a stable backend implementation is added. https://github.com/alibaba/OpenSandbox/pull/869

### 🐛 Bug Fixes
* Tune Kotlin sandbox pool degraded warmup backoff to reduce pressure during prolonged create failures. The degraded retry window now starts at an effective 30 seconds, grows up to a 1-day cap, and avoids advancing exponential attempts more than once for multiple concurrent warmup failures in the same reconcile batch. https://github.com/alibaba/OpenSandbox/pull/865 https://github.com/alibaba/OpenSandbox/pull/873

## 👥 Contributors
Thanks to these contributors ❤️

@ninan-nn
@Pangjiping