Struct InvokeRequest 

pub struct InvokeRequest {
    pub invocation: InvocationId,
    pub target: RemoteActionTarget,
    pub argument: InvokeArgument,
    pub context: Option<ActionContext>,
    pub confirmation: Option<Confirmation>,
    pub revision: Option<String>,
    pub on_behalf_of: Option<InvocationId>,
    pub wait_ms: Option<u32>,
    pub appearance: Option<Appearance>,
}

A request to run one published action.

Fields

invocation: InvocationId

Chosen by the caller and reused verbatim on retry; the host runs the action at most once per id.

target: RemoteActionTarget

argument: InvokeArgument

context: Option<ActionContext>

Human provenance carried into history. It never grants authority.

confirmation: Option<Confirmation>

The caller’s explicit confirmation, for an action whose contract requires one. The host checks it against the contract; it is evidence, not authority.

revision: Option<String>

The catalogue revision the caller chose the target from, for a provider whose actions are resolved live at that revision. A host refuses a target that no longer exists at it rather than guessing.

Omitted, a directory target resolves against the directory as it is now, and the admission is bound to the revision the provider resolved it at: an executing host still refuses the action once the directory moved on before it ran. An action whose contract asks for confirmation needs the revision it was shown at; without one the host refuses with CONFIRMED_ACTION_NEEDS_REVISION.

on_behalf_of: Option<InvocationId>

The live invocation this request continues: an edit an effect submits while running for someone else. The host admits it as that invocation’s original caller, with their grants, never as the app.

wait_ms: Option<u32>

Hold the receipt until the invocation settles or this many milliseconds pass (at most MAX_REMOTE_WAIT), so a quick action answers in one round trip. How the answer travels, not what runs: serve takes it off the request before the host sees it, and InvocationLedger ignores it. A host that predates it answers at admission, as before.

appearance: Option<Appearance>

The name and avatar a bot asks to show for this action. Only a door that can check the caller is a bot allowed it admits one (the room-action door a bot host drives); every other door refuses the request (crate::appearance::refuse_here) rather than dropping the field.

Implementations

impl InvokeRequest

pub fn same_invocation(&self, other: &InvokeRequest) -> bool

Whether other asks for the same invocation: every field but the transport-only wait_ms, so a retry that waits differently is still a retry.

Trait Implementations

impl Clone for InvokeRequest

fn clone(&self) -> InvokeRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InvokeRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InvokeRequest

fn deserialize<__D>( __deserializer: __D, ) -> Result<InvokeRequest, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for InvokeRequest

fn eq(&self, other: &InvokeRequest) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for InvokeRequest

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for InvokeRequest