Starstruk Logo MarkStarstruk

sdks/sandbox/go/v1.0.3

opensandbox-group/OpenSandboxsdks/sandbox/go/v1.0.3Jun 16, 2026by ninan-nn

AI Summary

Go SDK update introduces resource management features, improved file handling capabilities, and credential vault support. It also includes a migration for Code Interpreter runtime paths.

Key Highlights

  • Code Interpreter runtime paths migrated from /opt/opensandbox to /opt/code-interpreter
  • Added resourceRequests for Kubernetes-backed sandboxes to distinguish resource requests from limits
  • Added line-based file reading via GET /files/download with offset and limit parameters
  • Added directory listing support through the new execd directory API
  • Added detailed replace-content feedback to detect no-match and multi-match replacements

Breaking Changes

  • Code Interpreter runtime paths moved from /opt/opensandbox to /opt/code-interpreter. The Go SDK CodeInterpreterEntrypoint constant now points at the new path.

New Features

  • resourceRequests field in sandbox creation
  • Line-based file reads with offset and limit
  • Directory listing methods (ListDirectory and ListDirectoryWithDepth)
  • Detailed replace-content feedback with replacedCount values
  • 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