Struct Context 

pub struct Context { /* private fields */ }

Runtime context available to a code-defined capability tool.

This is a narrow projection: identity, locale, progress, and cancellation. Backend stores, credentials, tenant objects, registries, and host extensions intentionally remain host implementation details. Hosts build one per call via Context::new and the with_* seams; tests can do the same without any runtime.

Implementations

impl Context

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

Create a context with no-op progress and a never-cancelled signal.

pub fn with_locale(self, locale: Option<String>) -> Self

Set the resolved BCP 47 locale.

pub fn with_progress_sink(self, sink: Arc<dyn ProgressSink>) -> Self

Attach the host’s progress delivery seam.

pub fn with_cancellation_signal( self, signal: Arc<dyn CancellationSignal>, ) -> Self

Attach the host’s call-scoped cancellation signal.

pub fn tool_name(&self) -> &str

The tool name this context was created for.

pub fn session_id(&self) -> &str

Opaque session identifier for correlation and application-side scoping.

pub fn workspace_id(&self) -> &str

Opaque identifier of the workspace attached to this session.

pub fn locale(&self) -> Option<&str>

Resolved BCP 47 locale, when the host supplied one.

pub fn cancellation(&self) -> &CallCancellation

Call-scoped cancellation signal for work that may outlive execute.

pub async fn progress(&self, message: impl AsRef<str>)

Emit a best-effort, correlated tool.progress event.

Delivery failure never fails the tool.

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Context

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

Formats the value using the given formatter.