Struct ParamSchema 

pub struct ParamSchema {
    pub name: String,
    pub param_type: String,
    pub required: bool,
    pub default: Option<Value>,
    pub description: String,
    pub aliases: Vec<String>,
    pub consumes: usize,
}

Schema for a tool parameter.

Fields

name: String

Parameter name.

param_type: String

Type hint (string, int, bool, array, object, any).

required: bool

Whether this parameter is required.

default: Option<Value>

Default value if not required.

description: String

Description for help text.

aliases: Vec<String>

Alternative names/flags for this parameter (e.g., “-r”, “-R” for “recursive”).

consumes: usize

Number of positional tokens this non-bool flag consumes per occurrence.

Default 1 (standard --flag value). Set to 2 for --flag NAME VALUE patterns such as jq’s --arg / --argjson. When consumes > 1, the kernel collects each occurrence as an inner array and accumulates repeated occurrences under the same named key — the tool sees a Value::Json(Array(Array(...))) listing every (N-tuple) occurrence.

Implementations

impl ParamSchema

pub fn required( name: impl Into<String>, param_type: impl Into<String>, description: impl Into<String>, ) -> ParamSchema

Create a required parameter.

pub fn optional( name: impl Into<String>, param_type: impl Into<String>, default: Value, description: impl Into<String>, ) -> ParamSchema

Create an optional parameter with a default value.

pub fn with_aliases( self, aliases: impl IntoIterator<Item = impl Into<String>>, ) -> ParamSchema

Add alternative names/flags for this parameter.

Aliases are used for short flags like -r, -R that map to recursive.

pub fn consumes(self, n: usize) -> ParamSchema

Declare how many positional tokens this non-bool flag consumes per occurrence (--flag v1 v2 ...). Default is 1. Panics on 0 — a flag that consumes nothing is a bool flag, not a schema-typed param.

pub fn matches_flag(&self, flag: &str) -> bool

Check if a flag name matches this parameter or any of its aliases.

Trait Implementations

impl Clone for ParamSchema

fn clone(&self) -> ParamSchema

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParamSchema

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ParamSchema

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ParamSchema

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.