Struct HostSession 

pub struct HostSession {
    pub bot_name: String,
    pub session_id: String,
    pub agent_id: Option<String>,
    pub routine_url: Option<String>,
    pub routine_bearer: Option<String>,
    pub invite: Option<String>,
    pub tier: BackendKind,
}

One bot session the host says lives on this machine.

routine_url and routine_bearer are optional and stay in memory. They are not part of a session record on disk.

Fields

bot_name: String

Display name the host already shows (Alice, Привет мир).

session_id: String

Session id the host already assigned. This is the mail session, not the Grok Bot agent id.

agent_id: Option<String>

Grok Bot agent id for [createAgentAutomation]. Absent means this session does not get a webhook routine.

routine_url: Option<String>

Routine URL for this session, if the host has one. Not a file.

routine_bearer: Option<String>

Bearer for that routine POST. Memory only.

invite: Option<String>

The operator’s one-time invite code, needed only until this session’s identity is enrolled. Read by the client, never given to the agent.

tier: BackendKind

server tier (default) or matrix.

Implementations

impl HostSession

pub fn new(bot_name: impl Into<String>, session_id: impl Into<String>) -> Self

A session with no routine and no stored device bearer.

pub fn with_invite(self, invite: impl Into<String>) -> Self

The operator’s invite for this session’s first login.

pub fn with_tier(self, tier: BackendKind) -> Self

Which tier this session logs in on.

pub fn with_routine( self, url: impl Into<String>, bearer: Option<String>, ) -> Self

Attaches a routine target. The bearer is kept only as this value.

Trait Implementations

impl Debug for HostSession

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

Formats the value using the given formatter.