Struct AgentWorkspaceEnvironmentProfile 

pub struct AgentWorkspaceEnvironmentProfile { /* private fields */ }

Builder for common isolated agent workspace environments.

The builder is data-only. It lowers into core isolation DTOs and does not install runtimes, start containers, open sockets, resolve DNS, or configure host firewall state.

Implementations

impl AgentWorkspaceEnvironmentProfile

pub fn new(environment_id: impl Into<String>) -> Self

Creates a profile with safe defaults: no network, no ambient secrets, snapshot workspace mounts when a workspace is supplied, and cleanup-required lifecycle.

pub fn isolation_class(self, isolation_class: IsolationClass) -> Self

Sets the minimum isolation class required for this environment.

pub fn prefer_runtime(self, runtime_ref: impl Into<IsolationRuntimeRef>) -> Self

Adds a preferred runtime adapter ref. Selection still requires a registered adapter capability report that satisfies the package policy.

pub fn runtime(self, runtime: EnvironmentRuntime) -> Self

Sets the minimum isolation class and preferred adapter from a known toolkit runtime.

This is a data-only shortcut for calling Self::isolation_class with the runtime’s matching class and Self::prefer_runtime with its stable core IsolationRuntimeRef. It does not register adapters, start containers, open sockets, or relax host policy; runtime selection still requires a host-provided adapter capability report during execution.

pub fn workspace(self, workspace_ref: impl Into<String>) -> Self

Mounts a workspace by alias using the default snapshot mode.

pub fn workspace_with_mode( self, workspace_ref: impl Into<String>, mode: WorkspaceMountMode, ) -> Self

Mounts a workspace by alias with an explicit core workspace mode.

pub fn no_network(self) -> Self

Keeps the environment network disabled and requires a no-network guarantee.

pub fn egress_allowlist(self, allowlist: EgressAllowlist) -> Self

Applies a deterministic egress allowlist and requires adapter support for it.

pub fn require_capability(self, capability: IsolationCapability) -> Self

Adds a required isolation capability to the lowered requirement.

pub fn source(self, source: SourceRef) -> Self

Sets the source ref used for lineage.

pub fn destination(self, destination: DestinationRef) -> Self

Sets the destination ref used for lineage.

pub fn build(self) -> Result<AgentWorkspaceEnvironment, AgentError>

Builds the canonical core environment plus toolkit metadata.

Trait Implementations

impl Clone for AgentWorkspaceEnvironmentProfile

fn clone(&self) -> AgentWorkspaceEnvironmentProfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentWorkspaceEnvironmentProfile

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

Formats the value using the given formatter.