Enum ParamPosition 

pub enum ParamPosition {
    Path,
    Query,
    Body,
}

Where a declared parameter’s value lands, for the purposes of the D3 default length cap (Phase 128).

For a single-call HTTP tool this is the SAME answer tools.rs::build_operation gives as a crate::http::ParameterLocation — both derive it from path_placeholder_names and method_carries_request_body. See ToolDecl::param_position for the derivation and for what the previous divergence between the two cost (CR-02/CR-03).

Variants

Path

A {name} segment of the tool’s path template. Capped by default: a long value here has no legitimate use and is where the path-traversal class lives.

Query

A non-path parameter of a tool whose method carries NO request body — GET, HEAD, DELETE, OPTIONS — so the value travels in the query string. tools.rs::build_operation gives it crate::http::ParameterLocation::Query and crate::http::HttpClient::build_query appends it to the URL.

Capped at [server.validation] default_max_length code points by default, by default_cap_applies, because an unbounded query value is an unbounded request line: a 414 on some gateways, a truncation on others, and an access-log amplification everywhere. If a search tool starts refusing long queries after upgrading, this is why — declare an explicit max_length on that parameter to raise the limit.

Body

A POST / PUT / PATCH payload field, a SQL named bind, or a script-tool argument.

For a single-call HTTP tool this is a genuine JSON payload field: tools.rs::build_operation gives it crate::http::ParameterLocation::Body and crate::http::HttpClient::build_body folds it into the request body. It reaches no request line, which is why it is NOT capped by default (D-05 — free text must keep working). Surfaced by ServerConfig::lint and promotable to an error by [server.validation] strict.

Trait Implementations

impl Clone for ParamPosition

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ParamPosition

impl Debug for ParamPosition

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

Formats the value using the given formatter.

impl Eq for ParamPosition

impl Hash for ParamPosition

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ParamPosition

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ParamPosition