Struct AgentVm 

pub struct AgentVm { /* private fields */ }

One VM with coding agents in it: the Sandbox plus the specs it was built for.

Runtime-checked, like the sandbox it wraps, and for the same reason: one object is what the bindings can hold.

Implementations

impl AgentVm

pub fn new(sandbox: Sandbox, specs: Vec<AgentSpec>) -> Result<AgentVm, Error>

Wraps a sandbox for specs. Refuses an empty or repeated set.

pub async fn adopt( control: ControlPlane, specs: Vec<AgentSpec>, microvm_id: impl Into<String>, endpoint: impl Into<String>, agent_token: impl Into<String>, ) -> Result<AgentVm, Error>

An agent VM for a VM another process launched; see Sandbox::adopt.

AgentVm::from_name and AgentVm::adopt_in, which resolve credentials for a region, are in microvms_core::prelude.

The specs are the caller’s statement of what the VM carries, checked like AgentVm::new checks them. Read installed_agents first when the adopting process does not know.

pub fn detach(&mut self) -> Result<Detached, Error>

Hands the VM off to another process; see Sandbox::detach. The adopter passes the same specs to AgentVm::adopt.

pub fn into_parts(self) -> (Sandbox, Vec<AgentSpec>)

The sandbox and specs, for a binding that holds them separately.

pub fn claude_code(sandbox: Sandbox) -> AgentVm

A VM for Claude Code with the profile’s defaults.

pub fn codex(sandbox: Sandbox) -> AgentVm

A VM for Codex with the profile’s defaults.

pub fn specs(&self) -> Vec<AgentSpec>

The specs this VM carries, in profile order.

pub fn sandbox(&self) -> &Sandbox

pub fn sandbox_mut(&mut self) -> &mut Sandbox

pub fn session(&self) -> Option<&Session>

The session, once AgentVm::launch has run.

pub fn image_name(&self, request: &CreateImageRequest) -> String

The image name for these specs and this binary: the stem plus the first twelve hex characters of ensure’s identity over the artifact, the base and the size, so an unchanged binary, spec set and size name the image AgentVm::ensure_image would find (AGENT-3).

pub fn image_request( &self, binary: Vec<u8>, build_role_arn: impl Into<String>, size: SizeClass, ) -> Result<CreateImageRequest, Error>

The create request for this VM’s image, named per AgentVm::image_name.

code_artifact_uri is left empty for the caller to fill: the upload is theirs (this path does not upload), and the key they choose is usually derived from the name this method just computed. Sandbox::preflight refuses a request whose URI is still blank.

pub async fn build( &mut self, request: CreateImageRequest, ) -> Result<&Image, Error>

Builds the image. The caller has uploaded the artifact to the request’s URI.

pub async fn ensure_image( &mut self, binary: Vec<u8>, build_role_arn: impl Into<String>, size: SizeClass, s3_bucket: impl Into<String>, s3_key_prefix: Option<String>, ) -> Result<EnsuredImage, Error>

Builds or reuses this VM’s image through Sandbox::ensure_image (#258): named per AgentVm::image_name, reused when ready, waited on while building, rebuilt when failed, and uploaded to s3://<s3_bucket>/<s3_key_prefix>/<name>/artifact.zip only when a build is needed.

pub fn launch_request( &self, image_identifier: impl Into<String>, execution_role_arn: Option<String>, ) -> RunRequest

The launch request: egress on (AGENT-9), because neither agent reaches Bedrock without it, and the token label set to the image name.

pub async fn launch(&mut self, request: RunRequest) -> Result<&Session, Error>

Launches and waits for the daemon to answer, which Sandbox::run does.

pub async fn install_access(&self, access: &BedrockAccess) -> Result<(), Error>

install_access on this VM’s session.

pub async fn prompt( &self, agent: Agent, task: &str, options: &PromptOptions, ) -> Result<ExecHandle, Error>

prompt on this VM’s session, for one of the agents it carries.

pub async fn prompt_sync( &self, agent: Agent, task: &str, options: &PromptOptions, ) -> Result<ExecResult, Error>

prompt_sync on this VM’s session, for one of the agents it carries.

pub async fn terminate(&mut self, opts: TeardownOpts) -> TeardownReport

Tears the VM down; see Sandbox::terminate.

Trait Implementations

impl AgentVmExt for AgentVm

async fn from_name( store: &dyn NameStore, specs: Vec<AgentSpec>, name: &str, region: Option<Region>, port: Option<u16>, ) -> Result<Self, Error>

Adopts the VM registered as name in store; see Sandbox::from_name (SandboxExt::from_name).

fn adopt_in( region: Region, specs: Vec<AgentSpec>, microvm_id: impl Into<String>, endpoint: impl Into<String>, agent_token: impl Into<String>, port: Option<u16>, ) -> impl Future<Output = Result<Self, Error>> + Send

AgentVm::adopt over a plane resolved for region; the bindings’ entry point.

impl Debug for AgentVm

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

Formats the value using the given formatter.