sdks/sandbox/go/v1.0.3

yukangcao/DreamAvatarsdks/sandbox/go/v1.0.3Jun 16, 2026by ninan-nn

AI Summary

The Go Sandbox SDK v1.0.3 introduces resource configuration options, credential vault support, and enhanced file system operations.

Key Highlights

  • Added `resourceRequests` to sandbox creation for Kubernetes resource management.
  • Added Credential Vault support across the SDK surface.
  • Enhanced file operations with line-based reading and directory listing.

Breaking Changes

  • Code Interpreter runtime paths have moved from `/opt/opensandbox` to `/opt/code-interpreter`.

New Features

  • Resource requests for sandbox creation.
  • Line-based file reads with offset and limit.
  • Directory listing methods with depth control.
  • Detailed replace-content feedback with per-file counts.
  • Credential Vault support.

Full Release Notes

## What's New

### Breaking Changes

- Code Interpreter runtime paths have moved from `/opt/opensandbox` to `/opt/code-interpreter`, and the Go SDK `CodeInterpreterEntrypoint` constant now points at the new path. If you call `CreateCodeInterpreter()` without overriding the entrypoint, no change is needed. If you hardcoded the old path, update to `/opt/code-interpreter/code-interpreter.sh` when upgrading to images and SDK constants that include this migration. https://github.com/opensandbox-group/OpenSandbox/pull/1012

### 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, enabling Go callers to read large text files by line range.
- Added directory listing support through the new execd directory API. The Go SDK now has a plain `ListDirectory(ctx, path)` method that uses the server default depth and `ListDirectoryWithDepth(ctx, path, depth)` for explicit depth control. https://github.com/opensandbox-group/OpenSandbox/pull/1001
- Added detailed replace-content feedback without breaking existing callers. Existing replace behavior remains available, while detailed response types expose per-file `replacedCount` values so callers can detect no-match and multi-match replacements. https://github.com/opensandbox-group/OpenSandbox/pull/991
- Added Credential Vault support to the Go SDK surface, including model, adapter, sandbox creation, unit test, and E2E coverage. https://github.com/opensandbox-group/OpenSandbox/pull/1009 https://github.com/opensandbox-group/OpenSandbox/pull/1023

### Bug Fixes

- Directory listing now omits depth for the default path and uses an explicit method when callers need `depth=0` or another override. Entries are documented as lexically ordered within each directory. https://github.com/opensandbox-group/OpenSandbox/pull/1001
- Fixed resourceRequests-related Go SDK tests and generated model handling.
- Fixed replace-content detailed response handling while keeping existing replace usage compatible. https://github.com/opensandbox-group/OpenSandbox/pull/991

### Misc

- Prepared the Go Sandbox SDK module for tag `sdks/sandbox/go/v1.0.3`.

### Contributors

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