Struct WasmPluginRuntime 

pub struct WasmPluginRuntime { /* private fields */ }

Owns the wasmtime engine and can load + call plugins.

Implementations

impl WasmPluginRuntime

pub fn new() -> Result<Self, WasmPluginError>

Create a new runtime with a fresh wasmtime engine.

pub fn with_log_sink(self, sink: LogSink) -> Self

Install a LogSink. Builder form so callers can chain on the result of new(). The sink is cloned into every plugin instance the runtime builds — set it before loading plugins.

pub async fn load( &self, path: &Path, plugin_id: &str, capabilities: Capabilities, plugin_name: &str, env_map: HashMap<String, String>, ) -> Result<LoadedPlugin, WasmPluginError>

Load a .wasm component file. Calls the plugin’s init export and returns metadata + tool definitions.

pub async fn call_tool( &self, plugin_id: &str, tool_name: &str, args_json: &str, host_rt_handle: Handle, ) -> Result<CallToolResult, WasmPluginError>

Call a tool on a loaded plugin from async code. Creates a fresh Store per call (isolation — no shared mutable state between invocations).

This wrapper is intended for lightweight direct callers. The WasmTool adapter uses Self::call_tool_blocking inside tokio::task::spawn_blocking so wasmtime execution never blocks the async agent loop.

host_rt_handle is the runtime handle that the host imports (http-get/http-post) will use to drive async work.

pub fn call_tool_blocking( &self, plugin_id: &str, tool_name: &str, args_json: &str, host_rt_handle: Handle, ) -> Result<CallToolResult, WasmPluginError>

Synchronous tool call used from a plain blocking thread.

This is the safe path for sync wasmtime guest execution plus sync host imports that need to run async HTTP. The caller must invoke it outside a Tokio runtime context; then http-get / http-post can use host_rt_handle.block_on(...) without tripping Tokio’s nested-runtime guard.

pub async fn call_hook( &self, plugin_id: &str, point: HookPoint, context_json: &str, host_rt_handle: Handle, ) -> Result<Vec<HostAction>, WasmPluginError>

Invoke a v2 orchestration hook on a loaded plugin.

The returned actions are untrusted intent. Callers must validate model ids, role names, tools, and lifecycle timing before applying them to an agent or harness.

Trait Implementations

impl Debug for WasmPluginRuntime

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

Formats the value using the given formatter.