j8dZddlmZddlZddlZddlmZmZeje Z ej dZ dZ eGddZdd ZddZddZdS)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-namescBeZdZUdZded<edZded<dS) 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 MC:\Projects\DSCons\.venv\Lib\site-packages\mcp\shared\tool_name_validation.pyz!ToolNameValidationResult.%sr )default_factory list[str]warningsN)__name__ __module__ __qualname____doc____annotations__rrr r rrrsGNNN% ;;;H;;;;;;r rnamestrreturncg}|stddgSt|dkr#tddt|dgSd|vr|dd |vr|d |d s|d r|d |d s|d r|dt |sg}t}|D]E}tj d|s.||vr*||| |F|dd d|D|dtd|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, c34K|]}t|VdSr )repr).0cs r z%validate_tool_name..Ys*KkKkXYDQRGGKkKkKkKkKkKkr zLAllowed characters are: A-Z, a-z, 0-9, underscore (_), dash (-), and dot (.)T) rlenappend startswithendswithTOOL_NAME_REGEX fullmatchsetrematchaddjoin)rr invalid_charsseenchars rvalidate_tool_namer5(sH  '12     4yy3'bVYZ^V_V_bbbc     d{{STTT d{{STTT sqt}}S11qoppp spt}}S11pnooo  $ $T * * K#%   D8-t44 T9I9I$$T***m$))KkKk]jKkKkKkBkBkmmnnnfggg'JJJJ #TH E E EEr rrNonec<|sdStd|d|D]}td| tdtdtdtddS) 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)rrr9s rissue_tool_name_warningr;as  NN@@@@AAA))'g''(((( NN]^^^ NN`aaa NNC;CCCDDDDDr rcXt|}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. )r5r;rr )rresults rvalidate_and_warn_tool_namer>ss+  % %FD&/222 ?r )rrrr)rrrrrr6)rrrr)r __future__rloggingr. dataclassesrr getLoggerrr8compiler+r:rr5r;r>r r rrDs  #""""" ((((((((  8 $ $"*788a   < < < < < < <  <6F6F6F6FrEEEE$r