Struct WasmGuestExecutor 

pub struct WasmGuestExecutor { /* private fields */ }

Available on crate feature code only.

Guest-module backend for precompiled .wasm modules.

Executes guest modules through a constrained runtime with a narrow host ABI. This is clearly separate from raw JavaScript source execution — it accepts only ExecutionPayload::GuestModule payloads with GuestModuleFormat::Wasm.

Important Distinction

WasmGuestExecutor is NOT a JavaScript executor. It runs precompiled WebAssembly binary modules. For JavaScript source execution, use EmbeddedJsExecutor (secondary scripting) or ContainerCommandExecutor (container-isolated Node.js).

Example

use adk_code::{CodeExecutor, WasmGuestExecutor, ExecutionLanguage};

let executor = WasmGuestExecutor::new();
assert!(executor.supports_language(&ExecutionLanguage::Wasm));
assert!(!executor.supports_language(&ExecutionLanguage::JavaScript));
assert!(!executor.supports_language(&ExecutionLanguage::Rust));

Implementations

impl WasmGuestExecutor

pub fn new() -> WasmGuestExecutor

Create a new WASM guest executor with default configuration.

pub fn with_config(config: WasmGuestConfig) -> WasmGuestExecutor

Create a new WASM guest executor with the given configuration.

Trait Implementations

impl Clone for WasmGuestExecutor

fn clone(&self) -> WasmGuestExecutor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CodeExecutor for WasmGuestExecutor

fn name(&self) -> &str

Human-readable backend name.

fn capabilities(&self) -> BackendCapabilities

The capabilities this backend can enforce.

fn supports_language(&self, lang: &ExecutionLanguage) -> bool

Whether this backend supports the given language.

fn execute<'life0, 'async_trait>( &'life0 self, request: ExecutionRequest, ) -> Pin<Box<dyn Future<Output = Result<ExecutionResult, ExecutionError>> + Send + 'async_trait>>

where 'life0: 'async_trait, WasmGuestExecutor: 'async_trait,

Execute a request and return a structured result.

fn start<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), ExecutionError>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Start the execution environment (e.g., create and start a container).

fn stop<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), ExecutionError>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Stop the execution environment and release resources.

fn restart<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), ExecutionError>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Restart the execution environment.

fn is_running<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = bool> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Whether the execution environment is currently running.

fn prompt_snippet(&self) -> Option<String>

A prose snippet describing this backend’s execution environment and built-in capabilities, suitable for appending to an LLM-facing tool description.

impl Debug for WasmGuestExecutor

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

Formats the value using the given formatter.

impl Default for WasmGuestExecutor

fn default() -> WasmGuestExecutor

Returns the “default value” for a type.