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.

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

Attach the session that owns this tool call.

This is useful for desktop shells, test harnesses, and other callers that execute tools outside the full agent loop but still need session-aware callbacks such as MCP elicitation.

Trait Implementations

impl CallbackContext for SimpleToolContext

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

Returns the artifact store, if one is configured.

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

Returns the current invocation identifier.

fn agent_name(&self) -> &str

Returns the name of the currently executing agent.

fn user_id(&self) -> &str

Returns the user identifier for this session.

fn app_name(&self) -> &str

Returns the application name for this session.

fn session_id(&self) -> &str

Returns the session identifier.

fn branch(&self) -> &str

Returns the current conversation branch.

fn user_content(&self) -> &Content

Returns the user’s input content for this invocation.

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

Returns the function call ID for this tool invocation.

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,

Searches memory for entries matching the query.

fn emit_progress<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _stream: &'life1 str, _chunk: &'life2 str, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: Sync + 'async_trait,

Emit streaming progress output during long-running tool execution.

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

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

fn get_secret<'life0, 'life1, 'async_trait>( &'life0 self, _name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<String>, AdkError>> + Send + 'async_trait>>

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

Retrieve a secret by name from the configured secret provider.

fn get_secret_for_purpose<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, name: &'life1 str, purpose: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Option<String>, AdkError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: Sync + 'async_trait,

Resolves a secret, stating why it is needed.