Struct IdempotencyPath 

pub struct IdempotencyPath { /* private fields */ }

A field path into a call’s input, naming the value that identifies the operation.

Parsed once, at agent-build time, so a malformed declaration fails before a run rather than during one. See the module docs for the key format and the refusal rule.

Implementations

impl IdempotencyPath

pub fn parse(path: &str) -> Result<Self, IdempotencyPathError>

Parses a dotted field path.

"claim_id" is one segment; "payment.claim_id" is two, walked as object lookups in order. There is no array indexing and no escaping: a field whose name contains a dot cannot be named, which is a limit worth having while the syntax is one character wide.

Errors

IdempotencyPathError::Empty for an empty path, and IdempotencyPathError::EmptySegment for a path with an empty segment ("a.", ".a", "a..b"). Both are typos, and a typo in the declaration that names a payment must not survive to a run.

pub fn as_str(&self) -> &str

The path as the operator wrote it.

pub fn derive(&self, tool: &str, input: &Value) -> Result<String, ToolError>

Derives the key for one call, or refuses the call.

Returns <tool>:<value> where value is the non-empty string or the number at this path in input.

Errors

ToolError::MissingIdempotencyKey when the path is absent, runs through a non-object, or lands on anything but a non-empty string or a number. A boolean, a null, an object, an array, and an empty string are all refused: none of them names one operation, and a key that does not name one operation is worse than no key at all, because it looks like an identity while being a collision. The message names the tool, the path, and the keys the input actually carries.

Trait Implementations

impl Clone for IdempotencyPath

fn clone(&self) -> IdempotencyPath

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IdempotencyPath

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

Formats the value using the given formatter.

impl Eq for IdempotencyPath

impl PartialEq for IdempotencyPath

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for IdempotencyPath