o *ºi³ã@s|dZddlmZddlZddlZddlmZmZe e ¡Z e  d¡Z dZ eGdd„dƒƒZdd d „Zddd„Zddd„ZdS)a»Tool 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)Ú dataclassÚfieldz^[A-Za-z0-9._-]{1,128}$zPhttps://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool-namesc@s0eZdZUdZded<edd„dZded<d S) ÚToolNameValidationResultzÆResult 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. ÚboolÚis_validcCsgS©N©r r r ú\/home/ubuntu/veenaModal/venv/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 rÚnameÚstrÚreturncCs$g}|s tddgdSt|ƒdkrtddt|ƒ›dgdSd|vr'| d¡d |vr0| d ¡| d ¡s:| d ¡r?| d ¡| d ¡sI| d ¡rN| d¡t |¡sŒg}tƒ}|D]}t d|¡sp||vrp| |¡|  |¡qZ| dd  dd„|Dƒ¡›¡| d¡td|dStd|dS)zÓValidate 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)rré€z=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)Ú.0Úcr r r Ú Ys€z%validate_tool_name..zLAllowed characters are: A-Z, a-z, 0-9, underscore (_), dash (-), and dot (.)T) rÚlenÚappendÚ startswithÚendswithÚTOOL_NAME_REGEXÚmatchÚsetÚreÚaddÚjoin)rrÚ invalid_charsÚseenÚcharr r r Úvalidate_tool_name(s> þ þ       €    r.rr ÚNonecCs^|sdSt d|›d¡|D] }t d|›¡qt d¡t d¡t dt›d¡dS) z§Log 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.)ÚloggerÚwarningÚ 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)rÚresultr r r Úvalidate_and_warn_tool_namess r5)rrrr)rrrr rr/)rrrr)rÚ __future__rÚloggingr(Ú dataclassesrrÚ getLoggerrr0Úcompiler%r2rr.r3r5r r r r Ús    9