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<Self, 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<Self, Error>

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

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 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.

pub async 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>, ) -> Result<Self, Error>

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

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) -> Self

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

pub fn codex(sandbox: Sandbox) -> Self

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 the artifact content hash, so an unchanged binary and an unchanged spec set name the image build --reuse 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 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.

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 terminate(&mut self, opts: TeardownOpts) -> TeardownReport

Tears the VM down; see Sandbox::terminate.

Trait Implementations

impl Debug for AgentVm

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

Formats the value using the given formatter.