Visitar URL original
Base sandbox implementation with execute() as the only abstract method.
This class provides default implementations for all SandboxBackendProtocol methods using shell commands executed via execute(). Concrete implementations only need to implement execute(), uploadFiles(), and downloadFiles().
All shell commands use pure POSIX utilities (awk, grep, find, stat) that are available on any Linux including Alpine/busybox. No Python, Node.js, or other runtime is required on the sandbox host.
class BaseSandboxUnique identifier for the sandbox backend
Delete a file or directory from the sandbox via a server-side rm.
Runs test -e || test -L first: a path that does not exist (and is not a
broken symlink) returns a not-found error, matching the contract of
FilesystemBackend and StateBackend. Because a shell test has no error
channel, a non-zero probe conflates "absent" with "unstattable" (e.g. an
unsearchable parent directory); an unknown exit code is not treated as
absent and falls through to the delete.
Uses rm -rf, so directories are removed recursively along with their
contents. A non-zero rm exit (e.g. a permission error) is reported as a
failure.
Download multiple files from the sandbox. Implementations must support partial success.
Edit a file by replacing string occurrences.
Uses downloadFiles() to read, performs string replacement in TypeScript, then uploadFiles() to write back. No runtime needed on the sandbox host.
Memory-conscious: releases intermediate references early so the GC can reclaim buffers before the next large allocation is made.
Execute a command in the sandbox. This is the only method concrete implementations must provide.
Structured glob matching returning FileInfo objects.
Uses pure POSIX shell (find + stat) via execute() to list all files, then applies glob-to-regex matching in TypeScript. No Python or Node.js needed on the sandbox host.
Glob patterns are matched against paths relative to the search base:
* matches any characters except /** matches any characters including / (recursive)? matches a single character except /[...] character classesSearch for a literal text pattern in files using grep.
List files and directories in the specified directory (non-recursive).
Uses pure POSIX shell (find + stat) via execute() — works on any Linux including Alpine. No Python or Node.js needed.
Read file content with line numbers.
Uses pure POSIX shell (awk) via execute() — only the requested slice is returned over the wire, making this efficient for large files. Works on any Linux including Alpine (no Python or Node.js needed).
Read file content as raw FileData.
Uses downloadFiles() directly — no runtime needed on the sandbox host.
Upload multiple files to the sandbox. Implementations must support partial success.
Write content to a file, creating it or overwriting it if it already exists.
Uses uploadFiles() to write. No runtime needed on the sandbox host.