Starstruk Logo MarkStarstruk

sdks/sandbox/go/v1.0.3

mayswind/ezbookkeepingsdks/sandbox/go/v1.0.3Jun 16, 2026by ninan-nn

AI Summary

Updates the Go Sandbox SDK with a breaking change for code interpreter paths and introduces features for resource management, line-based file reading, directory listing, detailed content replacement, and Credential Vault support.

Key Highlights

  • Code Interpreter runtime paths migrated from `/opt/opensandbox` to `/opt/code-interpreter`.
  • Added `resourceRequests` for Kubernetes-backed sandboxes.
  • Added line-based file reading using `offset` and `limit` query parameters.
  • Added directory listing API with depth control.
  • Added Credential Vault support.

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.

New Features

  • Added `resourceRequests` to sandbox creation.
  • Added line-based file reads through `GET /files/download`.
  • Added directory listing support through execd directory API.
  • Added detailed replace-content feedback with per-file `replacedCount` values.
  • Added Credential Vault support to the Go SDK surface.

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