Struct InvocationContext 

pub struct InvocationContext {

    pub app_name: String,
    pub user_id: String,
    pub invocation_id: String,
    pub session: Arc<Mutex<Session>>,
    pub session_service: Arc<dyn SessionService>,
    pub artifact_service: Option<Arc<dyn ArtifactService>>,
    pub memory_service: Option<Arc<dyn MemoryService>>,
    pub credential_service: Option<Arc<dyn CredentialService>>,
    pub run_config: RunConfig,
    pub origin: InvocationOrigin,
    pub user_content: Option<Content>,
    pub llm_call_count: Arc<Mutex<u32>>,
    pub cancellation: CancellationToken,
    pub attributes: Arc<Mutex<HashMap<String, Value>>>,
    pub root_agent: Option<Arc<dyn BaseAgent>>,
}

Per-invocation context carried through the agent run.

Fields

app_name: String

App name.

user_id: String

User id.

invocation_id: String

Invocation id (unique per runner.run call).

session: Arc<Mutex<Session>>

The session being mutated. Wrapped in Arc<Mutex> so the runner and tool callbacks can both mutate state safely.

session_service: Arc<dyn SessionService>

Active session service.

artifact_service: Option<Arc<dyn ArtifactService>>

Optional artifact service.

memory_service: Option<Arc<dyn MemoryService>>

Optional memory service.

credential_service: Option<Arc<dyn CredentialService>>

Optional credential service.

run_config: RunConfig

Per-invocation config.

origin: InvocationOrigin

Origin of the invocation (CLI, web, API).

user_content: Option<Content>

User content for this invocation, if any.

llm_call_count: Arc<Mutex<u32>>

Counter of LLM calls performed (capped by RunConfig::max_llm_calls).

cancellation: CancellationToken

Cooperative cancellation flag. Agents check this at safe points and short-circuit cleanly when it flips. Flipped by crate::runner::Runner::cancel or by the A2A tasks/cancel handler — the same token plumbs through to both surfaces so cancels initiated from either side reach the in-flight agent.

attributes: Arc<Mutex<HashMap<String, Value>>>

Free-form attribute bag for plugins / agent-specific bookkeeping.

root_agent: Option<Arc<dyn BaseAgent>>

Root of the agent tree for this invocation (set by the runner). Agent transfer resolves targets from here, so an agent can reach siblings and ancestors, not just its own subtree.

Implementations

impl InvocationContext

pub fn new_id() -> String

Generate a fresh invocation id.

pub fn check_and_inc_llm_call(&self) -> Result<()>

Increment the LLM call counter. Returns Err if the cap was already reached.

pub fn is_cancelled(&self) -> bool

True if Self::cancellation has been flipped. Agents call this at safe points (between iterations of the LLM↔tool loop, between sub-agents) to halt cleanly.

Trait Implementations

impl Clone for InvocationContext

fn clone(&self) -> InvocationContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InvocationContext

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

Formats the value using the given formatter.