feat: implement advanced tools framework with thread-safe hooks, caching and external execution

[github-actions]

Summary

Implements the advanced tools framework that was originally in PR #980, with all critical issues fixed based on the comprehensive code reviews.

Key Features Implemented:

• Enhanced @advanced_tool decorator with hooks, caching, and external execution support
• Thread-safe global state using RLock for all shared data structures
• Async-safe external handlers with proper sync/async detection and execution
• Global hooks system with before/after execution hooks and priority levels
• TTL-based caching with configurable key generation and conditional caching
• External execution with handler registration and fallback mechanisms
• Structured input validation with Field, InputGroup, Choice, Range, Pattern classes
• Backward compatibility - doesn't interfere with existing tools system

Critical Issues Fixed:

1. Thread Safety: All global variables now protected with threading.RLock()
2. Async Handler Support: Proper detection and execution of async external handlers
3. Decorator Bare Usage: Fixed @advanced_tool (no parentheses) vs @advanced_tool() support
4. Parameter Names: Range constructor uses correct min_val/max_val parameters
5. Lambda Signatures: Removed problematic lambda usage in favor of proper function calls

Test Coverage:

✅ 8/8 comprehensive tests passing:

• Import functionality
• Bare decorator usage
• Parentheses decorator usage
• Caching with TTL
• External execution with handlers
• Global hooks (before/after)
• Input validation classes
• Thread safety mechanisms

Architecture:

• Follows AGENTS.md protocol-first design principles
• Thread-safe and async-safe implementation
• Minimal performance impact with lazy loading
• Clean separation from existing tools system

🤖 Generated with Claude Code

[MervinPraison]

Closing: auto-generated from closed issue #972. Superseded by #1214-#1217.

[github-actions]

Claude encountered an error —— View job

---

I'll analyze this and get back to you.