Struct SimpleToolContext 

pub struct SimpleToolContext { /* private fields */ }

A lightweight ToolContext with sensible defaults for non-agent callers.

Implements ReadonlyContext, CallbackContext, and ToolContext with minimal configuration. Construct via SimpleToolContext::new with a caller name; all other fields use safe defaults.

Implementations

impl SimpleToolContext

pub fn new(caller_name: impl Into<String>) -> Self

Create a new context with the given caller name.

Generates unique UUIDs for invocation_id and function_call_id. The caller name is returned by both agent_name() and app_name().

pub fn with_function_call_id(self, id: impl Into<String>) -> Self

Override the default function call ID.

By default a UUID is generated at construction. Use this builder method to provide a specific ID instead.

Trait Implementations

impl CallbackContext for SimpleToolContext

fn artifacts(&self) -> Option<Arc<dyn Artifacts>>

fn tool_outcome(&self) -> Option<ToolOutcome>

Returns structured metadata about the most recent tool execution. Available in after-tool callbacks and plugin hooks. Returns None when not in a tool execution context.

fn tool_name(&self) -> Option<&str>

Returns the name of the tool about to be executed. Available in before-tool and after-tool callback contexts.

fn tool_input(&self) -> Option<&Value>

Returns the input arguments for the tool about to be executed. Available in before-tool and after-tool callback contexts.

fn shared_state(&self) -> Option<Arc<SharedState>>

Returns the shared state for parallel agent coordination. Returns None when not running inside a ParallelAgent with shared state enabled.

impl ReadonlyContext for SimpleToolContext

fn invocation_id(&self) -> &str

fn agent_name(&self) -> &str

fn user_id(&self) -> &str

fn app_name(&self) -> &str

fn session_id(&self) -> &str

fn branch(&self) -> &str

fn user_content(&self) -> &Content

fn try_app_name(&self) -> Result<AppName, AdkError>

Returns the application name as a typed AppName.

fn try_user_id(&self) -> Result<UserId, AdkError>

Returns the user identifier as a typed UserId.

fn try_session_id(&self) -> Result<SessionId, AdkError>

Returns the session identifier as a typed SessionId.

fn try_invocation_id(&self) -> Result<InvocationId, AdkError>

Returns the invocation identifier as a typed InvocationId.

fn try_identity(&self) -> Result<AdkIdentity, AdkError>

Returns the stable session-scoped AdkIdentity triple.

fn try_execution_identity(&self) -> Result<ExecutionIdentity, AdkError>

Returns the full per-invocation ExecutionIdentity.

impl ToolContext for SimpleToolContext

fn function_call_id(&self) -> &str

fn actions(&self) -> EventActions

Get the current event actions. Returns an owned copy for thread safety.

fn set_actions(&self, actions: EventActions)

Set the event actions (e.g., to trigger escalation or skip summarization).

fn search_memory<'life0, 'life1, 'async_trait>( &'life0 self, _query: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<MemoryEntry>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn user_scopes(&self) -> Vec<String>

Returns the scopes granted to the current user for this invocation.