interface SandboxInstanceInterface for sandbox instances used in standard tests.
Extends the canonical SandboxBackendProtocol from deepagents with
test-specific properties (isRunning, initialize) and makes
uploadFiles/downloadFiles required (they are optional in the
base protocol).
Unique identifier for the sandbox backend instance
Whether the sandbox is currently running
Download multiple files (required for standard tests)
Edit a file by replacing string occurrences.
Execute a command in the sandbox.
Structured glob matching returning FileInfo objects.
Structured search results or error string for invalid input.
Searches file contents for a regex pattern.
Optional two-step initialization
Structured listing with file metadata.
Lists files and directories in the specified directory (non-recursive). Directories have a trailing / in their path and is_dir=true.
Read file content with line numbers or an error string.
Read file content as raw FileData.
Upload multiple files (required for standard tests)
Create a new file.