interface SandboxInstanceV2Interface for sandbox instances used in standard tests (v2).
Extends the canonical SandboxBackendProtocolV2 from deepagents with
test-specific properties (isRunning, initialize) and makes
uploadFiles/downloadFiles required (they are optional in the
base protocol).
V2 uses Result types for better error handling.
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.
Search file contents for a literal text pattern.
Binary files (determined by MIME type) are skipped.
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.
Read file content as raw FileData.
Upload multiple files (required for standard tests)
Create a new file.