Struct InvocationId 

pub struct InvocationId(/* private fields */);

A typed wrapper around a single execution or turn identifier.

Examples

use adk_core::identity::InvocationId;

// Parse from a known value
let iid = InvocationId::try_from("inv-001").unwrap();
assert_eq!(iid.as_ref(), "inv-001");

// Or generate a new UUID-based invocation ID
let generated = InvocationId::generate();
assert!(!generated.as_ref().is_empty());

Implementations

impl InvocationId

pub fn as_str(&self) -> &str

Returns the inner string slice.

pub fn new(value: impl Into<String>) -> Result<InvocationId, IdentityError>

Creates a typed identifier with validation.

Prefer this constructor at trust boundaries where the input may come from users, HTTP payloads, or external systems.

pub fn new_unchecked(value: impl Into<String>) -> InvocationId

Creates a typed identifier from a trusted string without validation.

Use this only for values that originate from internal runtime paths (e.g. session service, runner) where the string is already known to be valid. Prefer TryFrom or FromStr at trust boundaries.

impl InvocationId

pub fn generate() -> InvocationId

Generates a new random invocation identifier using UUID v4.

Examples

use adk_core::identity::InvocationId;

let a = InvocationId::generate();
let b = InvocationId::generate();
assert_ne!(a, b);

Trait Implementations

impl AsRef<str> for InvocationId

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<str> for InvocationId

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl Clone for InvocationId

fn clone(&self) -> InvocationId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InvocationId

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InvocationId

fn deserialize<__D>( __deserializer: __D, ) -> Result<InvocationId, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for InvocationId

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

Formats the value using the given formatter.

impl FromStr for InvocationId

type Err = IdentityError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<InvocationId, <InvocationId as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for InvocationId

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for InvocationId

fn cmp(&self, other: &InvocationId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for InvocationId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for InvocationId

fn partial_cmp(&self, other: &InvocationId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for InvocationId

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&str> for InvocationId

type Error = IdentityError

The type returned in the event of a conversion error.

fn try_from( s: &str, ) -> Result<InvocationId, <InvocationId as TryFrom<&str>>::Error>

Performs the conversion.

impl TryFrom<String> for InvocationId

type Error = IdentityError

The type returned in the event of a conversion error.

fn try_from( s: String, ) -> Result<InvocationId, <InvocationId as TryFrom<String>>::Error>

Performs the conversion.

impl Eq for InvocationId

impl StructuralPartialEq for InvocationId