Core Classes¶
The core classes provide the fundamental abstractions for tool management, execution, and integration within the ToolRegistry ecosystem.
Components¶
| Class | Description | Reference |
|---|---|---|
| ToolRegistry | Central orchestrator for tool registration, execution, and schema generation | Primary entry point |
| Tool | Represents an individual tool with metadata, parameters, and execution logic | Tool abstraction |
| Executor | Pluggable execution backends (thread/process) with cancellation and timeout | Execution engine |
| Events | Change event types and callback mechanism for registry state changes | Event infrastructure |
| Permissions | Rule-based authorization framework for controlling tool execution | Permission system |
Architecture¶
ToolRegistry (Orchestrator)
├── Tool (Abstraction)
│ ├── ToolMetadata (Behavioral metadata)
│ └── ToolTag (Classification tags)
├── Executor (Execution Engine)
│ ├── ThreadBackend
│ └── ProcessPoolBackend
├── Permission System
│ ├── PermissionPolicy (Rule engine)
│ ├── PermissionRule (Match + result)
│ └── PermissionHandler (ASK protocol)
└── Integration Modules
├── MCP Integration
├── OpenAPI Integration
├── LangChain Integration
└── Native Integration
See Also¶
- Helper Classes — Parameter validation and utility functions
- Integration Modules — Framework-specific integration classes
- Tool Wrappers — Adapter classes for external tool formats