Struct Args 

pub struct Args<'a> {
    map: &'a Map<String, Value>,
}

A tool’s arguments, read one by one; a wrong type is said in a sentence the agent can act on.

Fields

map: &'a Map<String, Value>

Implementations

impl Args<'_>

pub fn has(&self, name: &str) -> bool

Whether the argument was given (and is not null).

pub fn text(&self, name: &str) -> Result<Option<String>, String>

A text, trimmed; None when absent or empty.

pub fn needed(&self, name: &str) -> Result<String, String>

A text that must be there.

pub fn line(&self, name: &str) -> Result<Option<String>, String>

A text on one line, as a title, a subject or a place is written in its file: a line break becomes a space, other control characters go.

pub fn needed_line(&self, name: &str) -> Result<String, String>

A text on one line that must be there.

pub fn body(&self, name: &str) -> Result<String, String>

A text kept as written (a body, notes), less the blank at its end; its line breaks “\n”, no other control character.

pub fn flag(&self, name: &str) -> Result<bool, String>

True or false; “true” and “false” written as texts too, as models sometimes write them.

pub fn number( &self, name: &str, default: i64, least: i64, most: i64, ) -> Result<i64, String>

A whole number between least and most, default when absent; 15.0 and “15” read as 15.

pub fn list(&self, name: &str) -> Result<Vec<String>, String>

A list of texts; one text alone is a list of one.

pub fn decimal( &self, name: &str, least: f64, most: f64, ) -> Result<Option<f64>, String>

A number between least and most, none when absent; “0.9” read as 0.9.

pub fn date(&self, name: &str) -> Result<Option<Date>, String>

A day: “2026-10-05”.

pub fn moment(&self, name: &str) -> Result<Option<String>, String>

A day, or a day and a time, in the person’s time zone: “2026-10-05” or “2026-10-05T09:00”, as tasks and events write them. A time given with its offset or its zone (“…T07:00Z”, “…T09:00+02:00”) is moved to the person’s zone: jiff reads a civil time past its offset, which would shift it by the difference.