feat: allow users to add constraints and validators to ToolParam

[bcallender]

TL;DR

Added parameter constraints and validators to tool parameters to enable better validation of user inputs.

What changed?

• Added NumericConstraint and ToolParameterConstraints message types to the protocol buffer definitions
• Added constraints field to ToolParameter message to support numeric bounds (gt, ge, lt, le), multiple_of, min/max length, and regex pattern validation
• Added validator_names field to ToolParameter to support custom validators
• Implemented a validator registry system with a ParamValidator protocol
• Added a RegexValidator implementation with comprehensive regex validation
• Updated serialization/deserialization to handle the new constraint fields
• Modified the Pydantic model generation to apply constraints and validators
• Updated the MCP demo setup to use regex validators for query parameters

How to test?

1. Create a tool with parameter constraints:

tool = ToolParam(
    name="min_age",
    description="Filter `users` by minimum age.",
    constraints=ToolParamConstraints(gt=0, lt=120)
)

1. Create a tool with a regex validator:

tool = ToolParam(
    name="search_query",
    description="Regex pattern for querying user profile information",
    validator_names=["regex"]
)

1. Verify that invalid inputs are rejected with appropriate error messages when using the tool.

Why make this change?

This change enhances the tool parameter system by adding robust validation capabilities. By supporting both declarative constraints (like min/max values, length limits) and custom validators, we can ensure that user inputs meet specific requirements before executing tool functions. This improves error handling, security, and user experience by providing immediate feedback on invalid inputs rather than failing during execution.

[bcallender]

• feat: allow users to add constraints and validators to ToolParam #222 👈 (View in Graphite)
• feat: automated tool creation #163
• feat: declarative tool creation #150 : 1 other dependent PR (#153 )
• refactor: add .exprs() function to each LogicalPlan to get its referenced LogicalExprs #168
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.