Struct ChatbotTurnContext 

pub struct ChatbotTurnContext {
    pub user_id: Option<Uuid>,
    pub course_id: Option<Uuid>,
    pub course_name: Option<String>,
    pub conversation_id: Option<Uuid>,
    pub enabled_tool_categories: EnabledToolCategories,
    roles: OnceCell<Vec<Role>>,
}

Context for a chatbot turn, in two halves:

• who is asking: user_id, course_id, course_name, and the roles fetched from them.
• what the configuration offers: enabled_tool_categories, read once per request from the same configuration row the turn is assembled from.

Fields

user_id: Option<Uuid>

course_id: Option<Uuid>

course_name: Option<String>

conversation_id: Option<Uuid>

The conversation this turn belongs to. None only in tests that build a context without one; every production call site has a conversation id in scope.

enabled_tool_categories: EnabledToolCategories

roles: OnceCell<Vec<Role>>

Implementations

impl ChatbotTurnContext

pub fn new( user_id: Option<Uuid>, course_id: Option<Uuid>, course_name: Option<String>, conversation_id: Uuid, configuration: &ChatbotConfiguration, ) -> Self

Collects what a chatbot request needs to know about its caller and about what the chatbot’s configuration offers.

pub fn turn_resource(&self) -> Resource

The resource an offer-time check runs against, before any call has named a target: the course this chatbot belongs to, or global permissions for a chatbot that belongs to none.

pub(crate) async fn roles( &self, conn: &mut PgConnection, ) -> ChatbotResult<&[Role]>

The caller’s roles, fetched the first time an authorization check needs them.

One roles query per request however many authorization checks ask for them, and none at all for a request whose tools need no role.