Developer Docs — Core Internals
Reference documentation for ToolBoxV2 core utilities and infrastructure.
Core Types
| Doc |
Source File |
Description |
| Core Types |
utils/system/types.py |
AppType, Result, Request, @tb decorator |
| All Functions Enums |
utils/system/all_functions_enums.py |
Auto-generated dispatch table (tb -l -sfe) |
| FileHandlerV2 |
utils/system/file_handler.py |
Storage handler, scope detection, backends |
| Crypto Utilities |
utils/security/cryp.py |
AES/RSA encryption, signatures, hashing |
Infrastructure
| Doc |
Source File |
Description |
| RegistryClient |
utils/extras/registry_client.py |
TB-Registry client: install, publish, search |
| WorkerManager |
utils/clis/cli_worker_manager.py |
Worker process + Nginx management |
| WSWorker |
utils/workers/ws_worker.py |
WebSocket worker: connections, heartbeat |
| Toolbox Integration |
utils/workers/toolbox_integration.py |
AccessController, ModuleRouter, ZMQEventBridge |
| ManifestServiceManager |
utils/manifest/service_manager.py |
Manifest-driven service sync |
| Utils Analysis |
— |
Coverage matrix, loose ends, priorities |
User-Facing Utilities
| Doc |
Source File |
Description |
| Style |
utils/extras/Style.py |
ANSI colors, SpinnerManager, JSON extraction |
| Notifications |
utils/extras/notification.py |
Desktop toasts, messageboxes, progress bars |
| P2P CLI |
utils/clis/tcm_p2p_cli.py |
Encrypted chat, voice, file transfer |
| DB CLI Manager |
utils/clis/db_cli_manager.py |
MinIO bucket + credential management |
| User Manager |
utils/clis/user_manager.py |
Unified auth + MinIO user provisioning |
Helpers & Misc
| Doc |
Source File |
Description |
| State System |
utils/system/state_system.py |
Auto-update: download new tb executable |
| Cache |
utils/system/cache.py |
FileCache (shelve) + MemoryCache (dict+TTL) |
| Requirements Builder |
utils/extras/reqbuilder.py |
Stub — requirements.txt generator (not implemented) |
| Live Debugger |
utils/extras/live_debugger.py |
Thread + async task stack dumps |
| Fallback Tray |
utils/extras/fallback_tray.py |
System tray icon fallback |
How-to Guides
| Doc |
Source File |
Description |
| Docs Toolchain |
utils/extras/mkdocs.py |
DocsSystem: indexing, parsing, search |