Skip to main content

Module args_error

Module args_error 

Source
Expand description

Typed error surface for pre-canonicalisation argument validation failures.

ToolsetArgsError is the closed-set of all distinct refusal reasons returned by crate::validate_toolset_tool_args. This is a SEPARATE error type from crate::ToolsetFormatError, which is the TOOLSET.md-parse error enum.

The distinction matters: ToolsetFormatError covers static manifest format violations detected at parse/install time; ToolsetArgsError covers runtime argument-payload violations detected at dispatch time. They live on different code paths, are returned to different callers, and carry different semantics.

§Redaction discipline

No variant echoes any attacker-controlled input KEY (the input key string is not included — only the matched &'static str denylist constant is referenced), and no variant echoes any VALUE byte from the argument payload. This ensures that a carefully-crafted argument payload containing secret-shaped content (e.g. a key that looks like a mnemonic) can never leak through the error Display or Debug output.

Enums§

ToolsetArgsError
All distinct reasons crate::validate_toolset_tool_args can reject a payload.