Struct WasmRpc 

pub struct WasmRpc { /* private fields */ }

An RPC client for invoking remote agents

Implementations

impl WasmRpc

pub fn new( agent_type_name: &str, constructor: SchemaValueTree, phantom_id: Option<Uuid>, agent_config: Vec<TypedAgentConfigValue>, ) -> Self

Creates an RPC client connecting to the given target agent.

constructor is a value tree whose root encodes the target agent constructor’s parameter list. This fail-fast form traps if the client cannot be created and is intended for statically generated clients.

impl WasmRpc

pub fn create( agent_type_name: &str, constructor: SchemaValueTree, phantom_id: Option<Uuid>, agent_config: Vec<TypedAgentConfigValue>, ) -> Result<WasmRpc, RpcError>

Creates an RPC client connecting to the given target agent.

constructor is a value tree whose root encodes the target agent constructor’s parameter list. This fallible form returns an RPC error if the client cannot be created and is intended for reflective and other dynamic clients.

impl WasmRpc

pub fn invoke_and_await( &self, method_name: &str, input: SchemaValueTree, scope_card: Option<&PermissionCard>, ) -> Result<InvocationResultWithMetadata, RpcError>

Invokes a remote method with the given parameters, and awaits the result.

input encodes the method’s parameter list. The returned result is none for a unit output and some(value) for a single output.

impl WasmRpc

pub fn invoke( &self, method_name: &str, input: SchemaValueTree, scope_card: Option<&PermissionCard>, ) -> Result<InvocationMetadata, RpcError>

Triggers the invocation of a remote method with the given parameters, and returns its final identity immediately. Scope lending is not supported: scope-card must be none.

impl WasmRpc

pub fn async_invoke_and_await( &self, method_name: &str, input: SchemaValueTree, scope_card: Option<&PermissionCard>, ) -> AsyncInvocationWithMetadata

Invokes a remote method with the given parameters, and returns a future-invoke-result value which can be polled for the result together with the final invocation identity.

With this function it is possible to call multiple (different) agents simultaneously.

impl WasmRpc

pub fn schedule_invocation( &self, scheduled_time: Datetime, method_name: &str, input: SchemaValueTree, scope_card: Option<&PermissionCard>, ) -> Result<ScheduledInvocationReceipt, RpcError>

Schedules an invocation for later and returns its final identity. Scope lending is not supported: scope-card must be none.

impl WasmRpc

pub fn schedule_cancelable_invocation( &self, scheduled_time: Datetime, method_name: &str, input: SchemaValueTree, scope_card: Option<&PermissionCard>, ) -> Result<CancelableScheduledInvocationReceipt, RpcError>

Schedules an invocation for later and returns its final identity and cancellation capability. Call cancel on the returned resource to cancel the invocation before the scheduled time. Scope lending is not supported: scope-card must be none.

Trait Implementations

impl Debug for WasmRpc

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

Formats the value using the given formatter.