Struct ExecutionContext 

#[non_exhaustive]
pub struct ExecutionContext {
    pub owner: String,
    pub tenant: Option<String>,
    pub task_id: String,
    pub context_id: Option<String>,
    pub claims: Option<Value>,
    pub cancellation: CancellationToken,
    pub events: EventSink,
}

Context available to the executor during message processing.

Provides auth identity, tenant/task metadata, cooperative cancellation, and an EventSink for durable event emission. #[non_exhaustive] allows adding fields in future versions.

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.

owner: String

The authenticated owner (from middleware). Empty string for anonymous.

tenant: Option<String>

Tenant scope. None on default (un-tenanted) routes.

task_id: String

The task being processed.

context_id: Option<String>

Context ID for this conversation. None if not yet assigned.

claims: Option<Value>

Auth claims from middleware (JWT claims, API key metadata, etc.).

cancellation: CancellationToken

Cooperative cancellation token. Check cancellation.is_cancelled() in long-running loops to respect client cancellation.

events: EventSink

Durable event sink. Executors that want to drive task lifecycle themselves — progress artifacts, interrupted states, explicit terminal — call the methods on this sink.

Production send paths install a live sink that writes through the atomic store and fires the framework’s blocking-send awaiter on terminal or interrupted commit. ExecutionContext::anonymous returns a detached sink — emits return A2aError::Internal. Executor unit tests that don’t stand up a server can use it as-is; they simply cannot drive durable lifecycle events without real storage.

Implementations

impl ExecutionContext

pub fn anonymous(task_id: &str) -> Self

Create a context for anonymous/unauthenticated execution.

The events sink is EventSink::detached — emits return A2aError::Internal. Use this for executor unit tests that don’t need durable event persistence. Production code constructs ExecutionContext with a live sink wired to the framework’s atomic store.

Trait Implementations

impl Clone for ExecutionContext

fn clone(&self) -> ExecutionContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExecutionContext

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

Formats the value using the given formatter.