Struct SimulationEnvironment 

pub struct SimulationEnvironment {
    pub id: Uuid,
    pub label: String,
    pub branch: Branch,
    pub parent_branch_id: Uuid,
    pub started_at: DateTime<Utc>,
    pub scenario: SimulationScenario,
    pub status: SandboxStatus,
}

An isolated, forked branch environment used to run and evaluate agent simulations.

Example

let env = SimulationEnvironment::setup(&parent, scenario, config, lifecycle).await?;
let pool = env.branch_pool()?;
// run agent against pool ...
env.teardown(lifecycle).await?;

Fields

id: Uuid

A unique identifier for this simulation run.

label: String

A human-readable label for the sandbox branch.

branch: Branch

The isolated branch backing this environment.

parent_branch_id: Uuid

The parent branch from which this sandbox was forked.

started_at: DateTime<Utc>

The timestamp the environment was initialized.

scenario: SimulationScenario

The scenario definition that governs this run.

status: SandboxStatus

The current lifecycle status of the sandbox.

Implementations

impl SimulationEnvironment

pub async fn setup( parent: &Branch, scenario: SimulationScenario, _config: Arc<BranchConfig>, lifecycle: Arc<BranchLifecycle>, ) -> BranchResult<Self>

Forks parent into a new sandbox branch and returns an initialized environment.

The branch name follows the pattern sandbox/{scenario.name}/{id_short}.

pub async fn teardown( &mut self, lifecycle: Arc<BranchLifecycle>, ) -> BranchResult<()>

Discards the sandbox branch, freeing any on-disk state.

After calling teardown, the branch database is marked as Discarded and will be removed on the next GC pass.

pub async fn branch_pool(&self) -> BranchResult<SqlitePool>

Opens a read-write SQLite pool connected to the sandbox branch database.

Trait Implementations

impl Clone for SimulationEnvironment

fn clone(&self) -> SimulationEnvironment

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SimulationEnvironment

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.