o c۷i@s|dZddlmZddlZddlZddlmZmZee Z e dZ dZ eGdddZdd d ZdddZdddZdS)aTool name validation utilities according to SEP-986. Tool names SHOULD be between 1 and 128 characters in length (inclusive). Tool names are case-sensitive. Allowed characters: uppercase and lowercase ASCII letters (A-Z, a-z), digits (0-9), underscore (_), dash (-), and dot (.). Tool names SHOULD NOT contain spaces, commas, or other special characters. See: https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool-names ) annotationsN) dataclassfieldz^[A-Za-z0-9._-]{1,128}$zPhttps://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool-namesc@s0eZdZUdZded<edddZded<d S) ToolNameValidationResultzResult of tool name validation. Attributes: is_valid: Whether the tool name conforms to SEP-986 requirements. warnings: List of warning messages for non-conforming aspects. boolis_validcCsgSNr r r U/home/ubuntu/vllm_env/lib/python3.10/site-packages/mcp/shared/tool_name_validation.py%sz!ToolNameValidationResult.)default_factory list[str]warningsN)__name__ __module__ __qualname____doc____annotations__rrr r r r rs rnamestrreturncCs$g}|s tddgdSt|dkrtddt|dgdSd|vr'|dd |vr0|d |d s:|d r?|d |d sI|d rN|dt|sg}t}|D]}td|sp||vrp||| |qZ|dd dd|D|dtd|dStd|dS)zValidate a tool name according to the SEP-986 specification. Args: name: The tool name to validate. Returns: ToolNameValidationResult containing validation status and any warnings. FzTool name cannot be empty)rrz=Tool name exceeds maximum length of 128 characters (current: ) z9Tool name contains spaces, which may cause parsing issues,z9Tool name contains commas, which may cause parsing issues-zUTool name starts or ends with a dash, which may cause parsing issues in some contexts.zTTool name starts or ends with a dot, which may cause parsing issues in some contextsz[A-Za-z0-9._-]z'Tool name contains invalid characters: z, css|]}t|VqdSr)repr).0cr r r Ysz%validate_tool_name..zLAllowed characters are: A-Z, a-z, 0-9, underscore (_), dash (-), and dot (.)T) rlenappend startswithendswithTOOL_NAME_REGEXmatchsetreaddjoin)rr invalid_charsseencharr r r validate_tool_name(s>             r.rr NonecCs^|sdStd|d|D] }td|qtdtdtdtddS) zLog warnings for non-conforming tool names. Args: name: The tool name that triggered the warnings. warnings: List of warning messages to log. Nz"Tool name validation warning for "z":z - zHTool registration will proceed, but this may cause compatibility issues.zKConsider updating the tool name to conform to the MCP tool naming standard.z See SEP-986 (z) for more details.)loggerwarning SEP_986_URL)rrr1r r r issue_tool_name_warningas  r3rcCst|}t||j|jS)aCValidate a tool name and issue warnings for non-conforming names. This is the primary entry point for tool name validation. It validates the name and logs any warnings via the logging module. Args: name: The tool name to validate. Returns: True if the name is valid, False otherwise. )r.r3rr)rresultr r r validate_and_warn_tool_namess r5)rrrr)rrrr rr/)rrrr)r __future__rloggingr( dataclassesrr getLoggerrr0compiler%r2rr.r3r5r r r r s    9