Struct InboundMessageMeta 

#[non_exhaustive]
pub struct InboundMessageMeta {
    pub kind: InboundKind,
    pub sender_id: Option<String>,
    pub msg_id: Option<String>,
    pub inbound_ts: Option<DateTime<Utc>>,
    pub reply_to_msg_id: Option<String>,
    pub has_media: bool,
    pub origin_session_id: Option<Uuid>,
}

Per-turn metadata about the inbound message that triggered the agent turn.

Stamped on every tool call dispatched to a stdio extension or an MCP server (under params._meta.nexo.inbound). All fields except kind are optional; consumers must tolerate absence and branch gracefully.

Example — external user message

use nexo_tool_meta::{InboundKind, InboundMessageMeta};

let meta = InboundMessageMeta::external_user("+5491100", "wa.ABCD1234");
assert_eq!(meta.kind, InboundKind::ExternalUser);
assert_eq!(meta.sender_id.as_deref(), Some("+5491100"));
assert_eq!(meta.msg_id.as_deref(), Some("wa.ABCD1234"));

Example — internal system tick

use nexo_tool_meta::{InboundKind, InboundMessageMeta};

let meta = InboundMessageMeta::internal_system();
assert_eq!(meta.kind, InboundKind::InternalSystem);
assert!(meta.sender_id.is_none());
assert!(meta.msg_id.is_none());

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.

kind: InboundKind

Origin discriminator. Always present when the bucket is.

sender_id: Option<String>

Provider-native sender id (E.164 phone, telegram_user_id, RFC822 from-address, slack U-id, …). None for kinds other than ExternalUser and for paths where the provider does not expose a sender id (e.g. webhook with no auth).

msg_id: Option<String>

Provider-native message id (single canonical, no shortened alias). Used for idempotency, dedupe, and as the reply_to_msg_id target on subsequent turns. When a debounce window collapses several inbound messages into a single turn, this carries the id of the first message in the batch.

inbound_ts: Option<DateTime<Utc>>

Inbound timestamp in UTC. Wire shape: RFC3339 string via chrono’s serde adapter. Producers must clamp wildly-skewed provider timestamps to now() before emitting.

reply_to_msg_id: Option<String>

Provider-native id of the message this one replies to. None when the inbound is not a reply.

has_media: bool

true when the inbound carries non-text media (image/audio/video/file/sticker). Microapps gate media-aware tools on this; the actual bytes/URLs live in arguments, not in _meta.

origin_session_id: Option<Uuid>

Origin session id when kind == InterSession (delegation receive). None otherwise.

Implementations

impl InboundMessageMeta

pub fn external_user( sender_id: impl Into<String>, msg_id: impl Into<String>, ) -> Self

Build the minimum meta for an external user message (channel plugin / webhook / MCP-channel inbound).

pub fn internal_system() -> Self

Build the meta for a heartbeat / scheduler tick or a yaml-declared internal_system event-subscriber binding.

pub fn inter_session(origin_session_id: Uuid) -> Self

Build the meta for an inter-agent delegation receive. origin_session_id is required — None would be indistinguishable from internal_system.

pub fn with_ts(self, ts: DateTime<Utc>) -> Self

Builder: layer the inbound timestamp.

pub fn with_reply_to(self, reply_to_msg_id: impl Into<String>) -> Self

Builder: layer the reply-to message id.

pub fn with_media(self) -> Self

Builder: flag that the inbound carries non-text media.

Trait Implementations

impl Clone for InboundMessageMeta

fn clone(&self) -> InboundMessageMeta

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InboundMessageMeta

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InboundMessageMeta

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for InboundMessageMeta

fn eq(&self, other: &InboundMessageMeta) -> 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 InboundMessageMeta

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TS for InboundMessageMeta

type WithoutGenerics = InboundMessageMeta

If this type does not have generic parameters, then WithoutGenerics should just be Self. If the type does have generic parameters, then all generic parameters must be replaced with a dummy type, e.g ts_rs::Dummy or ().
The only requirement for these dummy types is that EXPORT_TO must be None.

type OptionInnerType = InboundMessageMeta

If the implementing type is std::option::Option<T>, then this associated type is set to T. All other implementations of TS should set this type to Self instead.

fn ident(cfg: &Config) -> String

Identifier of this type, excluding generic parameters.

fn docs() -> Option<String>

JSDoc comment to describe this type in TypeScript - when TS is derived, docs are automatically read from your doc comments or #[doc = ".."] attributes

fn name(cfg: &Config) -> String

Name of this type in TypeScript, including generic parameters

fn decl_concrete(cfg: &Config) -> String

Declaration of this type using the supplied generic arguments. The resulting TypeScript definition will not be generic. For that, see TS::decl(). If this type is not generic, then this function is equivalent to TS::decl().

fn decl(cfg: &Config) -> String

Declaration of this type, e.g. type User = { user_id: number, ... }. This function will panic if the type has no declaration.

fn inline(cfg: &Config) -> String

Formats this types definition in TypeScript, e.g { user_id: number }. This function will panic if the type cannot be inlined.

fn inline_flattened(cfg: &Config) -> String

Flatten a type declaration. This function will panic if the type cannot be flattened.

fn visit_generics(v: &mut impl TypeVisitor)

where Self: 'static,

Iterates over all type parameters of this type.

fn output_path() -> Option<PathBuf>

Returns the output path to where T should be exported, relative to the output directory. The returned path does not include any base directory.

fn visit_dependencies(v: &mut impl TypeVisitor)

where Self: 'static,

Iterates over all dependency of this type.

fn dependencies(cfg: &Config) -> Vec<Dependency>

where Self: 'static,

Resolves all dependencies of this type recursively.

fn export(cfg: &Config) -> Result<(), ExportError>

where Self: 'static,

Manually export this type to the filesystem. To export this type together with all of its dependencies, use TS::export_all.

fn export_all(cfg: &Config) -> Result<(), ExportError>

where Self: 'static,

Manually export this type to the filesystem, together with all of its dependencies. To export only this type, without its dependencies, use TS::export.

fn export_to_string(cfg: &Config) -> Result<String, ExportError>

where Self: 'static,

Manually generate bindings for this type, returning a String. This function does not format the output, even if the format feature is enabled.

impl Eq for InboundMessageMeta

impl StructuralPartialEq for InboundMessageMeta