idZddlmZddlZddlZddlmZmZeje Z ejdZ dZ eGddZd d Zd d Zdd Zy)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:eZdZUdZded<edZded<y) 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_validcgSNr _/root/aria/mcps/aria-brain/venv/lib/python3.12/site-packages/mcp/shared/tool_name_validation.pyz!ToolNameValidationResult.%sr )default_factory list[str]warningsN)__name__ __module__ __qualname____doc____annotations__rrr r rrrsN ;Hi;r rcg}|stddgSt|dkDrtddt|dgSd|vr|jdd |vr|jd |jd s|j d r|jd |jd s|j d r|jdt j |sg}t}|D]@}tj d|r||vs|j||j|B|jddjd|D|jdtd|Std|S)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)r rz=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, c32K|]}t|ywr )repr).0cs r z%validate_tool_name..YsKkXYDQRGKkszLAllowed characters are: A-Z, a-z, 0-9, underscore (_), dash (-), and dot (.)T) rlenappend startswithendswithTOOL_NAME_REGEXmatchsetreaddjoin)namer invalid_charsseenchars rvalidate_tool_namer2(suH '12   4y3'UVYZ^V_U``abc   d{ST d{ST st}}S1op st}}S1no   &#%  D88-t4T9I$$T*  A$))Kk]jKkBkAlmnfg'JJ #TH EEr c|sytjd|d|D]}tjd|tjdtjdtjdtdy) 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)r.rr5s rissue_tool_name_warningr7asr  NN7vR@A)gY'() NN]^ NN`a NN];-/BCDr c\t|}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. )r2r7rr )r.results rvalidate_and_warn_tool_namer:ss&  %FD&//2 ??r )r.strreturnr)r.r;rrr<None)r.r;r<r)r __future__rloggingr+ dataclassesrr getLoggerrr4compiler(r6rr2r7r:r r rrCsp # (   8 $"**78a   < <  <6FrE$r