Struct SecretRequest 

pub struct SecretRequest {
    pub name: String,
    pub tool_name: Option<String>,
    pub app_name: Option<String>,
    pub user_id: Option<String>,
    pub session_id: Option<String>,
    pub invocation_id: Option<String>,
    pub purpose: Option<String>,
}

Core traits and types.

Always available regardless of feature flags. Includes:

• Agent - The fundamental trait for all agents
• Tool / Toolset - For extending agents with capabilities
• Session / State - For managing conversation context
• Event - For streaming agent responses
• AdkError / Result - Unified error handling A described secret access.

Carries the requested name plus the identity the framework observed at the call site, so a SecretService can authorize and audit rather than being handed a bare name with no context.

Example

use adk_core::SecretRequest;

let request = SecretRequest::new("payments-api-key")
    .with_tool_name("charge_card")
    .with_purpose("authorize a customer payment");

assert_eq!(request.tool_name.as_deref(), Some("charge_card"));

Fields

name: String

Name of the requested secret.

tool_name: Option<String>

The tool making the request, when the access came from a tool.

Set by the framework from the tool it dispatched, never from a value the tool provided.

app_name: Option<String>

Application the run belongs to.

user_id: Option<String>

Authenticated user the run belongs to.

session_id: Option<String>

Session the run belongs to.

invocation_id: Option<String>

Invocation the access happened in, for correlating audit records.

purpose: Option<String>

Why the secret is needed, when the caller states it.

Implementations

impl SecretRequest

pub fn new(name: impl Into<String>) -> SecretRequest

Creates a request for name with no identity attached.

pub fn with_tool_name(self, tool_name: impl Into<String>) -> SecretRequest

Attaches the requesting tool’s name.

pub fn with_identity( self, app_name: impl Into<String>, user_id: impl Into<String>, session_id: impl Into<String>, ) -> SecretRequest

Attaches the run’s identity.

pub fn with_invocation_id( self, invocation_id: impl Into<String>, ) -> SecretRequest

Attaches the invocation the access happened in.

pub fn with_purpose(self, purpose: impl Into<String>) -> SecretRequest

Attaches a stated purpose.

Trait Implementations

impl Clone for SecretRequest

fn clone(&self) -> SecretRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SecretRequest

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

Formats the value using the given formatter.

impl Default for SecretRequest

fn default() -> SecretRequest

Returns the “default value” for a type.

impl Eq for SecretRequest

impl PartialEq for SecretRequest

fn eq(&self, other: &SecretRequest) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SecretRequest