Skip to main content

Module agent_args

Module agent_args 

Source
Expand description

Agent-native payload reduction flags, shared by every subcommand.

§Why these live in their own struct

Declaring how much of the payload reaches the caller is a different concern from declaring how the request is made. The transport knobs (crate::cli::Cli: timeouts, retries, cache) describe the fetch; these describe the emission. Keeping them apart means a reduction knob can be added without touching the transport surface, and crate::agent_ops takes one value instead of a growing argument list.

§Query limits versus emission limits

search-in-crate --limit and search-crates --per-page bound the query: they decide how much upstream work happens. AgentArgs::max_items bounds the emission: it decides how much of the already-computed result is written to stdout. The names differ because the things differ — and because a second --limit would collide, which clap rejects outright with “Long option names must be unique for each argument”.

Structs§

AgentArgs
Payload reduction knobs applied to the JSON envelope before it is written.