Starstruk Logo MarkStarstruk

java/sandbox/v1.0.16

Graphify-Labs/graphifyjava/sandbox/v1.0.16Jul 13, 2026by Pangjiping

AI Summary

Introduces isolation convenience APIs, session management, and credential vault placeholders to the Java/Kotlin sandbox SDK.

Key Highlights

  • New isolation convenience APIs (runOnce and withSession) for one-shot and scoped workflows
  • Sandbox pool destroy support with FORCE-destroy semantics
  • Credential Vault placeholder substitutions for request surfaces
  • Removed deprecated CredentialMatch.ports logic

Breaking Changes

  • CredentialMatch.ports removed; intercept port is now derived from scheme
  • PoolStateStoreContentionException removed (never actually raised)

New Features

  • Isolation convenience APIs for one-shot and scoped workflows
  • List isolated sessions functionality
  • Isolated bind mounts with arbitrary host→namespace mappings
  • Credential Vault placeholder substitutions

Full Release Notes

## What's New

### ✨ Features

- **Isolation convenience APIs** — `isolation.runOnce(code, workspace, ...)` and `isolation.withSession(req) { ... }` for one-shot / scoped sessions with guaranteed cleanup. (#1222)
- **List isolated sessions** — `sandbox.isolation().list()`. (#1269)
- **Isolated bind mounts** — `CreateIsolatedSessionRequest.binds` accepts `BindMount(source, dest, readonly)` for arbitrary host→namespace mappings; also exposes `uidMode`. (#1264)
- **Sandbox pool destroy** — `SandboxPoolManager` FORCE-destroy with `DESTROYING` fence + `DESTROYED` tombstone, supported by both in-memory and Redis stores. (#1225)
- **Credential Vault placeholder substitutions** — opt-in placeholders for `path` / `query` / `header` / `body` (incl. `passthrough` bindings). (#1251)
- `IsolationService` now declares `runOnce` / `withSession` as default methods — custom implementations may need to accept the defaults. (#1222)
- `CredentialMatch.ports` removed; intercept port is derived from scheme (`http`→80, `https`→443). Drop any `.ports(...)` calls. (#1189)
- `PoolStateStoreContentionException` removed (never actually raised). (#1198)

### 📦 Misc

- Bump to `1.0.16`; realign default `User-Agent` (`OpenSandbox-Kotlin-SDK/1.0.16`) which had lagged, with a regression test to prevent future drift. (#1248)

### 👥 Contributors

- @jianpingpei
- @jwx0925
- @ninan-nn
- @Pangjiping