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§
- Agent
Args - Payload reduction knobs applied to the JSON envelope before it is written.