Validate Preset String • AI Agent SDK

</div>

This function is defined in the parse_utils module.

Raise a helpful error when a string does not name a known preset.

Non-string values pass through untouched, so callers can hand this the raw parameter without pre-checking the type. Matching is case-insensitive, ignores surrounding whitespace, and treats `-/_ as interchangeable, mirroring the preset lookups performed by the parameter resolvers (e.g. PermissionMode.resolve accepts both accept_edits and accept-edits`). This keeps the guard from rejecting spellings the downstream resolver would happily accept.

Signature

def validate_preset_string(param_name: str, value: Any, presets: Iterable[str]) -> None

Parameters

Exceptions

Uses

• canonical_preset_key
• make_preset_error

Source