Interface 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).
interface SandboxInstanceUnique 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.