Base sandbox implementation with execute() as the only abstract method.
This module provides a base class that implements all SandboxBackendProtocol methods using shell commands executed via execute(). Concrete implementations only need to implement the execute() method.
It also defines the BaseSandbox implementation used by the CLI sandboxes.
Result from backend edit operations.
Result of code execution.
Simplified schema optimized for LLM consumption.
Result of a single file download operation.
The response is designed to allow partial success in batch operations. The errors are standardized using FileOperationError literals for certain recoverable conditions for use cases that involve LLMs performing file operations.
Structured file listing info.
Minimal contract used across backends. Only "path" is required. Other fields are best-effort and may be absent depending on backend.
Result of a single file upload operation.
The response is designed to allow partial success in batch operations. The errors are standardized using FileOperationError literals for certain recoverable conditions for use cases that involve LLMs performing file operations.
Structured grep match entry.
Extension of BackendProtocol that adds shell command execution.
Designed for backends running in isolated environments (containers, VMs, remote hosts).
Adds execute()/aexecute() for shell commands and an id property.
See BaseSandbox for a base class that implements all inherited file
operations by delegating to execute().
Result from backend write operations.
Base sandbox implementation with execute() as abstract method.
This class provides default implementations for all protocol methods using shell commands. Subclasses only need to implement execute().
