Struct CallOrigin 

#[non_exhaustive]
pub struct CallOrigin {
    pub carrier: Principal,
    pub call_key: String,
    pub message_position: Option<MessagePosition>,
}

Who really asked for a call that another module relays.

When a module forwards a tool call on behalf of a different caller, the provider sees the forwarding module as the route’s principal and the forwarder’s own call_key. This records the caller behind it, so the provider can attribute the call in its logs and ledgers.

It is a claim made by the forwarding module, not something the daemon checks: a provider may record it but must never grant or refuse anything because of it. Authority stays with the route’s own principal.

#[non_exhaustive] so a later member is an additive change; build it with CallOrigin::new.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

carrier: Principal

The original caller, in the same form the daemon stamps on a route.

call_key: String

The original caller’s key for the call, with the same bounds as ToolCallRequest::call_key; check it with validate_call_origin.

message_position: Option<MessagePosition>

Where the call sits in the model message that asked for it, when the forwarder knows. None means unknown, never “first” or “alone”.

Implementations

impl CallOrigin

pub fn new(carrier: Principal, call_key: impl Into<String>) -> Self

An origin naming carrier as the caller and call_key as its key, with no message position.

pub fn with_message_position(self, position: MessagePosition) -> Self

Set where the call sits in the model message that asked for it.

Trait Implementations

impl Clone for CallOrigin

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CallOrigin

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CallOrigin

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CallOrigin

impl PartialEq for CallOrigin

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CallOrigin

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CallOrigin