Starstruk Logo MarkStarstruk

python/sandbox/v0.1.9

opensandbox-group/OpenSandboxpython/sandbox/v0.1.9May 12, 2026by ninan-nn

AI Summary

The Python SDK gains new capabilities for metadata management and diagnostics, allowing for JSON merge-patch updates and retrieving diagnostic logs/events. It also optimizes the sandbox pool warmup process to handle prolonged failures more efficiently.

Key Highlights

  • New sandbox metadata patch support (Add, Update, Delete behavior)
  • Stable Diagnostics API support with `get_diagnostic_logs` and `get_diagnostic_events`
  • Tuned sandbox pool degraded warmup backoff (30s to 1-day cap)

New Features

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

Full Release Notes

## What's New

### ✨ Features
* Add sandbox metadata patch support to the Python SDK. Async and sync `Sandbox` / `SandboxManager` flows can now apply JSON merge-patch updates through the new metadata patch API, including add, update, and delete behavior for metadata keys. The generated lifecycle bindings and handwritten adapters were updated to match the new spec and server implementation. 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 Python SDK. Async and sync clients now expose `get_diagnostic_logs` and `get_diagnostic_events` from both `Sandbox` and `SandboxManager`, backed by generated diagnostic client bindings, adapters, converters, and focused tests. `scope` is required for the stable API; existing legacy DevOps behavior is preserved for old clients, while the current open-source server returns `DIAGNOSTICS_NOT_IMPLEMENTED` for stable diagnostic requests until the backend implementation lands. https://github.com/alibaba/OpenSandbox/pull/869

### 🐛 Bug Fixes
* Tune Python sandbox pool degraded warmup backoff to reduce backend and quota 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