Struct ToolContext 

pub struct ToolContext {
    pub meta: Meta,
    /* private fields */
}

Tool execution context

Thread-safe context using Arc<DashMap> for extensions. Can be freely cloned and passed across await points.

Thread Safety

All operations are thread-safe:

• insert, get, remove use DashMap’s concurrent HashMap
• Extensions wrapped in Arc<T> for cheap cloning

Examples

use descry_tool_core::ToolContext;
use std::sync::Arc;

let ctx = Arc::new(ToolContext::new());

// Insert extension
#[derive(Debug)]
struct MyService;
ctx.insert(MyService);

Fields

meta: Meta

Request metadata

Implementations

impl ToolContext

pub fn new() -> Self

Create a new context with empty args

pub fn with_args(args: JsonObject) -> Self

Create context with args

pub fn empty() -> Self

Create empty context

pub fn with_meta(self, meta: Meta) -> Self

Set metadata

pub fn take_args(&mut self) -> Option<JsonObject>

Take and consume the raw arguments

This can only be called once. Subsequent calls will return None.

pub fn peek_args(&self) -> Option<&JsonObject>

Peek at the raw arguments without consuming

pub fn insert<T>(&self, ext: T) -> Option<Arc<T>>

where T: Send + Sync + 'static,

Insert an extension into the context

Returns the previous value if it existed.

pub fn get<T>(&self) -> Option<Arc<T>>

where T: Send + Sync + 'static,

Get a reference to an extension

pub fn remove<T>(&self) -> Option<Arc<T>>

where T: Send + Sync + 'static,

Remove an extension from the context

pub fn contains<T>(&self) -> bool

where T: Send + Sync + 'static,

Check if an extension exists

pub fn clear(&self)

Clear all extensions

pub fn len(&self) -> usize

Get extension count

pub fn is_empty(&self) -> bool

Check if extensions is empty

Trait Implementations

impl Clone for ToolContext

fn clone(&self) -> ToolContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolContext

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

Formats the value using the given formatter.

impl Default for ToolContext

fn default() -> Self

Returns the “default value” for a type.