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 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 (S3 is not in this crate’s dependency set), 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.