sandbox

package
v0.0.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 17, 2026 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Index

Constants

View Source
const (
	// SandboxWorkspace is the workspace directory inside the sandbox.
	SandboxWorkspace = "/tmp/workspace" //nolint:gosec // not a credential
	// SandboxClaudeConfig is the Claude config directory inside the sandbox.
	SandboxClaudeConfig = "/tmp/claude-config" //nolint:gosec // not a credential

)

Variables

This section is empty.

Functions

func Create

func Create(name string, providers []string, image, policy string) error

Create creates a persistent OpenShell sandbox and waits for it to be ready. If providers are given, they are passed as --provider flags. If image is non-empty, it is passed as --from to start the sandbox from a container image. If policy is non-empty, it is applied at creation time via --policy.

func Delete

func Delete(name string) error

Delete deletes a sandbox, returning any error for the caller to log.

func EnsureAvailable

func EnsureAvailable() error

EnsureAvailable checks that the openshell binary is in PATH.

func EnsureGateway

func EnsureGateway() error

EnsureGateway starts a local gateway if none is active. It is idempotent — if a gateway is already running the command is a no-op.

func EnsureProvider

func EnsureProvider(name, providerType string, credentials, config map[string]string) error

EnsureProvider creates or updates a provider on the gateway. Credential values may contain ${VAR} references which are expanded from the host environment before being passed to openshell.

Credentials use the bare-key form (--credential KEY) so that secret values never appear on the process command line. The expanded values are injected into the child process environment, where openshell reads them directly. See https://docs.nvidia.com/openshell/latest/sandboxes/manage-providers#bare-key-form

func ExtractOutputFiles

func ExtractOutputFiles(sshConfigPath, sandboxName, remoteDir, localDir string) ([]string, error)

ExtractOutputFiles copies all files under a remote directory in the sandbox to a local output directory, preserving relative paths.

func ExtractTranscripts

func ExtractTranscripts(sshConfigPath, sandboxName, agentName, outputDir string) error

ExtractTranscripts copies Claude transcript files (.jsonl) from the sandbox to a local output directory.

func GetSSHConfig

func GetSSHConfig(name string) (string, error)

GetSSHConfig retrieves the SSH config for a sandbox.

func RsyncFrom

func RsyncFrom(sshConfigPath, sandboxName, remoteDir, localDir string) error

RsyncFrom copies a directory from a sandbox to the local machine using rsync with safety flags: symlinks are skipped (--no-links) and .git/hooks/ is excluded to prevent a compromised sandbox from injecting executable content into the host repo. Requires rsync on both host and sandbox.

func SCP

func SCP(sshConfigPath, sandboxName, localPath, remotePath string) error

SCP copies a local file or directory into a sandbox.

func SCPFrom

func SCPFrom(sshConfigPath, sandboxName, remotePath, localPath string) error

SCPFrom copies a file or directory from a sandbox to the local machine.

func SSH

func SSH(sshConfigPath, sandboxName, command string, timeout time.Duration) (stdout, stderr string, exitCode int, err error)

SSH runs a command inside a sandbox and returns stdout, stderr, and exit code.

func SSHStream

func SSHStream(sshConfigPath, sandboxName, command string, timeout time.Duration, stdoutW, stderrW *os.File) (int, error)

SSHStream runs a command inside a sandbox, streaming output to the given writers.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL