mindXdashboard/docs/book/journal/api/dojo/inference/governance/origin
philosophymanifestothesisoriginwhitepaperataraxiaroadmappress|archovervieworchestrationcodebasehierarchycore|agentsmindXagentceomastermindbdievolutionauthorall
govdaiocivilizationidentitysecurity|memorypgvectorembedaglmmemory|inferencevllmollamamistralgemini|timeoracle
toolsindextoolsa2amcpshell|publishauthoragentbookjournal|deployproductionsecuritymonitoring|apireferenceswagger|learnusageguidehackathon
TOOLS.md · 11.6 KB

MindX Tools Registry Reference

Comprehensive Tool Documentation & Registry

Version: 4.0 Date: 2026-03-31 Status: ✅ Production Ready - Enterprise deployment with encrypted vault security Purpose: Complete reference for all tools in the mindX orchestration environment

🎯 Tool Architecture Overview

mindX operates on a fundamental separation of concerns between agents (intelligence) and tools (action). Tools provide deterministic functionality without decision-making overhead, enabling scalable and secure operations.

🔧 Tool Design Principles

  1. Single Responsibility: Each tool does ONE thing exceptionally well
  2. Clear Interfaces: Standardized execute() method with defined parameters
  3. No Decision Logic: Tools perform actions, agents make decisions
  4. Access Control: Fine-grained permissions and security boundaries
  5. Registry Integration: Centralized discovery and management

📋 REGISTERED TOOLS (Official Registry)

Core System Tools

💻 CLI Command Tool (cli_command_tool)

- execute(command_name: str, args: dict) - Execute CLI command by name

🔍 Audit and Improve Tool (audit_and_improve)

- execute(target_path: str, prompt: str) - Audit and improve codebase

📊 Base Generation Agent (base_gen_agent)

- execute(root_path_str: str) - Generate Markdown summary of codebase

Memory & Documentation Tools

📝 Note Taking Tool (note_taking)

- execute(action: str, topic: str, content?: str) - Perform note-taking action

✂️ Summarization Tool (summarization)

- execute(text: str) - Summarize provided text

System Analysis & Management Tools

🔍 System Analyzer Tool (system_analyzer)

- execute(analysis_focus_hint?: str) - Analyze system for improvements

🏥 System Health Tool (system_health)

💻 Shell Command Tool (shell_command)

- execute(command: str) - Execute shell command

Registry & Factory Tools

📋 Registry Manager Tool (registry_manager)

- execute(registry_type: str, action: str, item_id: str, item_config?: dict)

🔐 Registry Sync Tool (registry_sync)

- execute(action?: str, validate_signatures?: bool, update_missing_keys?: bool)

🏭 Agent Factory Tool (agent_factory)

- execute(action: str, agent_type?: str, agent_id?: str, agent_config?: dict)

🔧 Tool Factory Tool (tool_factory)

- execute(action: str, tool_id?: str, tool_config?: dict)

Advanced Intelligence Tools

🧠 Augmentic Intelligence Tool (augmentic_intelligence)

- execute(capability: str, ...) - Execute augmentic intelligence operations

Development & Coding Tools

💻 Simple Coder Agent (simple_coder_agent)

- execute(command: str, path?: str, content?: str) - Execute file/shell command

Web & Search Tools

🌐 Web Search Tool (web_search)

- execute(query: str) - Perform web search

Monitoring & Cost Management Tools

💰 Token Calculator Tool (token_calculator)

- execute(action: str, ...) - Perform token cost calculations and tracking - Actions: estimate_cost, track_usage, get_usage_report, check_budget, get_metrics, optimize_prompt - High-precision Decimal arithmetic for financial calculations - Thread-safe operations with comprehensive error handling - Real-time budget monitoring with alerting (75% threshold default) - Multi-provider support (Google, OpenAI, Anthropic, Groq, Mistral) - Advanced caching and rate limiting (300 calls/minute) - Production-grade metrics collection and circuit breaker pattern - execute(action: "estimate_cost", text: str, model: str, operation_type?: str) - Estimate operation cost - execute(action: "track_usage", agent_id: str, operation: str, model: str, input_tokens: int, output_tokens: int, cost_usd: float) - Track actual usage - execute(action: "get_usage_report", agent_id?: str, days_back?: int) - Generate usage reports - execute(action: "optimize_prompt", original_prompt: str, max_tokens: int, cost_budget: float, target_model: str) - Optimize prompts for cost - execute(action: "check_budget") - Check current budget status - execute(action: "get_metrics") - Get comprehensive system metrics

📊 Tool Statistics

🔧 Tool Access Control Matrix

ToolMastermindCoordinatorGuardianStrategic EvolutionAll Agents
CLI Command✅✅✅✅✅
Audit & Improve✅❌❌❌❌
Base Gen Agent✅❌❌❌❌
Note Taking✅✅✅✅✅
Summarization✅✅✅✅✅
System Analyzer❌❌❌✅❌
System Health❌❌✅❌❌
Shell Command✅❌❌❌❌
Registry Manager✅❌❌✅❌
Registry Sync✅✅❌❌❌
Agent Factory✅✅✅✅✅
Tool Factory✅✅✅✅✅
Augmentic Intelligence✅✅✅✅✅
Simple Coder✅❌❌❌❌
Web Search✅✅✅✅✅
Token Calculator✅✅✅✅✅

🎯 Tool Development Priorities

Immediate (Critical)

  1. ✅ TokenCalculatorTool - Cost management and optimization (COMPLETED)
  2. Enable System Health Tool - Guardian agent functionality
  3. Enable Web Search Tool - Research capabilities

High Priority

  1. Performance Monitor Tool - System performance tracking
  2. Memory Analysis Tool - Memory pattern analysis
  3. Model Selection Tool - LLM optimization

Medium Priority

  1. File Management Tool - Advanced file operations
  2. Database Tool - Data persistence and retrieval
  3. API Integration Tool - External service connectivity

🔧 Tool Integration Guidelines

Creating New Tools

  1. Inherit from BaseTool class
  2. Implement standardized execute() method
  3. Define clear parameter schemas
  4. Add to official tools registry
  5. Set appropriate access controls

Tool Security

Tool Testing

This documentation reflects the current state of tool registration and provides a comprehensive reference for tool usage, development, and integration within the mindX orchestration environment.

All DocumentsDocument IndexThe Book of mindXImprovement JournalAPI Reference