Status: ✅ Production Ready - Enterprise deployment with BANKON vault security Author: Professor Codephreak (© Professor Codephreak) Organizations: AgenticPlace, cryptoAGI, AION-NET, augml Resources: rage.pythai.net | mindx.pythai.net | Thesis | Manifesto | THOT | iNFT | Ollama Cloud Inference: Local qwen3:0.6b→1.7b (CPU) | Ollama Cloud free tier (36+ GPU models) | Task-to-model correlation Architecture: Self-Aware Augmentic Intelligence with Machine Learning Integration Last Updated: April 2026
The mindX CORE system is the foundational cognitive and orchestration infrastructure that enables autonomous Augmentic Intelligence. CORE comprises the essential components that other agents depend upon for reasoning, identity, memory, coordination, and system orchestration. Governed by the DAIO Constitution with BONA FIDE reputation containment enforced by JudgeDread.
CORE = Cognitive Foundation + Infrastructure Services + Orchestration Layer
The CORE system includes 15 foundational components across three critical layers:
Critical Distinction: CORE agents are the foundational components that enable all other functionality. They are NOT the specialized agents (coding, monitoring, learning) but the infrastructure that makes them possible.
┌─────────────────────────────────────────────────────────────────┐
│ CORE ORCHESTRATION LAYER │
│ Self-Aware Augmented Intelligence │
│ (Contains all subsystems) │
├─────────────────────────────────────────────────────────────────┤
│ 🧠 COGNITIVE ARCHITECTURE LAYER │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ MindXAgent (Meta-Agent — inference-first autonomous loop)│ │
│ │ ├─ Understands all agents (meta-knowledge) │ │
│ │ ├─ Drives autonomous improvement loop │ │
│ │ └─ InferenceDiscovery validates model before each cycle│ │
│ │ ↓ │ │
│ │ BDIAgent (Reasoning Core) ←→ AGInt (P-O-D-A Loop) │ │
│ │ ├─ Belief-Desire-Intention logic │ │
│ │ ├─ Tool execution & planning │ │
│ │ └─ Failure recovery │ │
│ │ ↓ │ │
│ │ BeliefSystem (Singleton) ←→ EpistemicAgent │ │
│ │ ├─ Confidence-scored beliefs │ │
│ │ ├─ Source tracking │ │
│ │ └─ Shared across all agents │ │
│ └─────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────────┤
│ 🔧 INFRASTRUCTURE SERVICES LAYER │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ CoordinatorAgent (Service Bus) │ │
│ │ ├─ Event pub/sub system │ │
│ │ ├─ Interaction routing │ │
│ │ └─ Health monitoring │ │
│ │ ↓ │ │
│ │ MemoryAgent (Persistence) ←→ IDManagerAgent (Identity) │ │
│ │ ├─ Timestamped records (STM → LTM → archive) │ │
│ │ ├─ machine.dreaming (7-phase consolidation cycle) │ │
│ │ ├─ Pattern analysis + pgvector semantic search │ │
│ │ └─ Context retrieval + LTM awareness for perception │ │
│ │ ↓ │ │
│ │ GuardianAgent (Security) ←→ SessionManager │ │
│ │ ├─ Access control │ │
│ │ ├─ Identity verification │ │
│ │ └─ Challenge-response auth │ │
│ └─────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────────┤
│ 🎼 ORCHESTRATION LAYER │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ MastermindAgent (Strategic Control) │ │
│ │ ├─ High-level objectives │ │
│ │ ├─ Campaign management │ │
│ │ └─ Strategic directives │ │
│ │ ↓ │ │
│ │ ┌─────────────────────────────────────────────────┐ │ │
│ │ │ AION AUTONOMOUS AGENT │ │ │
│ │ │ Receives MASTERMIND directives • Maintains │ │ │
│ │ │ decision autonomy • Chroot management │ │ │
│ │ │ ├── SystemAdmin Agent │ │ │
│ │ │ ├── Backup Agent │ │ │
│ │ │ └── AION.sh (Exclusive Control) │ │ │
│ │ └─────────────────────────────────────────────────┘ │ │
│ │ ↓ │ │
│ │ StartupAgent ←→ ShutdownAgent ←→ SystemStateTracker │ │
│ │ ├─ Bootstrap sequence │ │
│ │ ├─ Graceful shutdown │ │
│ │ └─ State management │ │
│ └─────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────────┤
│ 🛠️ CORE UTILITY SERVICES │
│ StuckLoopDetector • ExitDetector • InferenceOptimizer │
│ ModelScorer • ReasoningAgent • NonMonotonicAgent │
│ OllamaChatManager • Config • LoggingConfig │
└─────────────────────────────────────────────────────────────────┘
AION (Autonomous Interoperability and Operations Network Agent) operates within a sophisticated containment structure:
Autonomy vs. Containment Balance:
Operational Flow:
CORE System → MASTERMIND → Directive → AION → Autonomous Decision → Action/Refusal
↑ ↓
└─────── Feedback Loop ─────────────┘
agents/core/mindXagent.py (~149KB, ~3,800 lines)agents/orchestration/mastermind_agent.py) is the strategic orchestrator. MindXAgent is the meta-agent that understands all agents and drives autonomous self-improvement.agent_knowledge: Comprehensive knowledge base of all agents
- agent_capabilities: Detailed capability mapping
- improvement_goals: Self-improvement target management
- orchestrate_improvement(): Coordinate improvement campaigns
- analyze_agent_capabilities(): Deep agent understanding
agents/core/bdi_agent.py (~64KB, ~1,900 lines)belief_system: Shared belief management
- desires: Goal state management
- intentions: Action plan generation
- execute_tool(): Tool execution with context
- failure_analyzer: Intelligent error recovery
agents/core/agint.py (~32KB, ~950 lines)run_poda_loop(): Execute complete cognitive cycle
- process_primary_directive(): Handle main objectives
- stuck_loop_detector: Infinite loop prevention
- exit_detector: Completion condition detection
agents/core/belief_system.py (~8KB, ~210 lines)beliefs: Dict[str, Belief] with confidence scores
- update_belief(): Thread-safe belief updates
- query_beliefs(): Context-aware belief retrieval
- Source tracking (PERCEPTION, INFERENCE, LEARNED, etc.)
agents/orchestration/coordinator_agent.py (~56KB, ~1,600 lines)interactions: Request/response tracking
- subscribers: Event pub/sub system
- health_status: System health metrics
- route_interaction(): Request routing
- publish_event(): Event broadcasting
agents/memory_agent.py (~53KB, ~1,300 lines)save_timestamped_memory(): Store timestamped records
- promote_stm_to_ltm(): Memory promotion based on importance
- analyze_agent_patterns(): Extract behavioral patterns
- get_agent_memory_context(): Context retrieval for tasks
agents/core/id_manager_agent.py (~16KB, ~500 lines)create_new_wallet(): Generate Ethereum-compatible wallets
- store_identity(): Maintain identity records
- map_entity_to_address(): Entity ↔ address mapping
- sign_message(): Cryptographic message signing
agents/guardian_agent.py (~16KB, ~500 lines)agents/orchestration/mastermind_agent.py (~41KB, ~1,200 lines)agents/orchestration/startup_agent.py (~83KB, ~2,400 lines)bootstrap_system(): Complete system initialization
- Agent dependency resolution and startup ordering
- Registry loading and agent registration
- Configuration and environment setup
agents/orchestration/system_state_tracker.py (~20KB)agents/core/reasoning_agent.py) - Deductive/inductive reasoning engineagents/core/epistemic_agent.py) - Knowledge and certainty managementagents/core/nonmonotonic_agent.py) - Non-monotonic reasoning with belief revisionagents/core/session_manager.py) - Session lifecycle managementagents/core/stuck_loop_detector.py) - Infinite loop detectionagents/core/exit_detector.py) - Completion condition detectionagents/core/inference_optimizer.py) - LLM inference optimizationagents/core/model_scorer.py) - Model performance evaluationagents/core/ollama_chat_manager.py) - Persistent LLM connectionsutils/config.py) - Configuration management and environment loadingutils/logging_config.py) - Logging infrastructure setupInput (Belief/Goal/Directive)
↓
BeliefSystem.query_beliefs()
↓ [Context-aware belief retrieval]
BDIAgent.reason()
↓ [Apply BDI logic: Beliefs + Desires → Intentions]
Generate Action Plans
↓ [Select tools and parameters]
Execute Tools via tools_registry
↓ [Tool execution with error handling]
Update Beliefs via BeliefSystem
↓ [Propagate new knowledge]
Log Results via MemoryAgent
↓ [Persist execution context]
Output (Actions taken, State updated, Goals achieved)
System Analysis Phase:
Monitor all agents via agent_knowledge
Analyze capabilities via agent_capabilities
Review improvement history via MemoryAgent
Identify improvement opportunities
Improvement Planning Phase:
Generate improvement goals via improvement_goals
Select priority targets
Plan improvement campaigns
Execution Phase:
Delegate to appropriate agents:
- BDIAgent for reasoning tasks
- StrategicEvolutionAgent for campaign planning
- CoordinatorAgent for system coordination
Monitor execution progress
Track results via result_analyses
Learning Phase:
Compare expected vs actual outcomes
Update beliefs via BeliefSystem
Log improvements via improvement_history
Adjust future strategies
Request Reception:
Receive Interaction (query, analysis, improvement, registration)
Classify interaction type
Apply rate limiting via concurrency_semaphore
Routing Phase:
Route to appropriate handler
Monitor execution via performance_monitor
Track resource usage via resource_monitor
Event Management:
Publish events to subscribers (pub/sub)
Handle event propagation
Manage event ordering
Response Phase:
Track completion status
Aggregate results
Return structured response
Update health_status
Data Collection:
Raw Events/Interactions/Results
↓
MemoryAgent.save_timestamped_memory()
↓ [Timestamp + metadata + importance scoring]
Short-Term Memory (STM) Storage
Pattern Analysis:
MemoryAgent.analyze_agent_patterns()
↓ [Pattern recognition across time series]
Identify Important Patterns
↓
MemoryAgent.promote_stm_to_ltm()
↓ [Promote high-importance memories]
Long-Term Memory (LTM) Storage
Belief Update:
Pattern Insights → BeliefSystem.update_belief()
↓ [Update confidence scores and sources]
Propagate to all agents using BeliefSystem
↓ [Shared singleton access]
BDIAgent + AGInt + MindXAgent use updated beliefs
BeliefSystem: Single shared instance across ALL agents
# All agents access the same belief store
belief_system = BeliefSystem.get_instance()
agent1.belief_system == agent2.belief_system # True
Why Critical: Ensures consistent worldview across all reasoning agents
MindXAgent orchestrates by injecting CORE services:
class MindXAgent:
def __init__(self):
self.belief_system = BeliefSystem.get_instance()
self.bdi_agent = BDIAgent(belief_system=self.belief_system)
self.memory_agent = MemoryAgent.get_instance()
self.coordinator = CoordinatorAgent.get_instance()
CoordinatorAgent implements pub/sub for loose coupling:
# Agents subscribe to system events
coordinator.subscribe("agent_registration", handler)
coordinator.subscribe("improvement_complete", handler)
Events propagate across system
coordinator.publish_event("system_state_change", data)
StartupAgent and AgentBuilderAgent dynamically create agents:
# Agent creation with proper dependency injection
agent = AgentBuilderAgent.build_agent(
agent_type="specialized",
dependencies={"belief_system": belief_sys, "memory": memory_agent}
)
BDIAgent uses different reasoning strategies:
# Different reasoning approaches based on context
if context.requires_deductive:
result = ReasoningAgent.deductive_reasoning(premises)
elif context.requires_nonmonotonic:
result = NonMonotonicAgent.revise_beliefs(new_evidence)
Must be present for basic system function:
Specialized agents that depend on CORE infrastructure:
agents/learning/)agents/monitoring/)llm/) - Model providerstools/) - Specialized toolsapi/) - HTTP endpointsmindx_backend_service/) - Web servicesPhase 1: Foundation (Synchronous)
Config.load() ← Environment and settings
LoggingConfig.setup() ← Logging infrastructure
BeliefSystem.get_instance() ← Singleton belief store
VaultManager.init() ← Secure storage (if enabled)
Phase 2: Core Infrastructure (Async)
MemoryAgent.initialize() ← Memory infrastructure
IDManagerAgent.get_instance() ← Identity management
GuardianAgent.initialize() ← Security services
SessionManager.initialize() ← Session management
Phase 3: Cognitive Core (Async)
BDIAgent.initialize() ← Reasoning engine
AGInt.initialize() ← Cognitive orchestrator
CoordinatorAgent.get_instance() ← Service bus
StartupAgent.bootstrap_system() ← Complete bootstrap
Phase 4: Orchestration (Async)
MindXAgent.get_instance() ← Meta-orchestrator
MastermindAgent.get_instance() ← Strategic controller
SystemStateTracker.initialize() ← State management
Phase 5: Specialized Agents (Non-CORE)
StrategicEvolutionAgent ← Improvement framework
Specialized agents ← Domain-specific capabilities
Tool registry ← External tools
API services ← HTTP endpoints
Dependency Validation: Each phase ensures all dependencies from previous phases are ready before proceeding.
MindXAgent continuously monitors the system:
agent_knowledge: Real-time understanding of all agentsagent_capabilities: Dynamic capability assessmentimprovement_history: Learning from past optimizationsCoordinatorAgent provides real-time metrics:
health_status: System health across all componentsperformance_monitor: LLM call metrics and latencyresource_monitor: CPU, memory, and storage utilizationMemoryAgent enables pattern recognition:
class NetworkMonitor:
"""
Advanced network monitoring with Machine Learning analysis
© Professor Codephreak - rage.pythai.net
"""
def __init__(self):
self.interface_monitor = NetworkInterfaceMonitor()
self.bandwidth_analyzer = BandwidthAnalyzer()
self.latency_tracker = LatencyTracker()
self.ml_predictor = NetworkMLPredictor()
self.threat_detector = NetworkThreatDetector()
async def monitor_network_health(self):
"""Continuous network health monitoring with ML analysis"""
# Real-time metrics collection
metrics = await self.collect_network_metrics()
# Machine Learning analysis for patterns
patterns = self.ml_predictor.analyze_traffic_patterns(metrics)
# Predictive bandwidth optimization
optimization = self.bandwidth_analyzer.optimize_allocation(patterns)
# Threat detection and response
threats = self.threat_detector.scan_for_threats(metrics)
return {
'current_metrics': metrics,
'ml_patterns': patterns,
'optimization_recommendations': optimization,
'security_status': threats,
'health_score': self.calculate_network_health_score(metrics, patterns)
}
class CPUMonitor:
"""
Advanced CPU monitoring with Machine Learning optimization
© Professor Codephreak - rage.pythai.net
"""
async def monitor_cpu_health(self):
"""Comprehensive CPU health monitoring with ML optimization"""
# Real-time CPU metrics
metrics = await self.collect_cpu_metrics()
# Machine Learning workload prediction
workload_prediction = self.ml_optimizer.predict_workload(metrics)
# Performance optimization recommendations
optimizations = self.ml_optimizer.recommend_optimizations(metrics)
return {
'current_metrics': metrics,
'workload_prediction': workload_prediction,
'optimization_recommendations': optimizations,
'health_score': self.calculate_cpu_health_score(metrics)
}
class GPUMonitor:
"""
GPU utilization and memory monitoring
© Professor Codephreak - rage.pythai.net
"""
async def monitor_gpu_resources(self):
"""Real-time GPU monitoring for ML workloads"""
return {
'gpu_utilization': await self.get_gpu_utilization(),
'gpu_memory': await self.get_gpu_memory_usage(),
'gpu_temperature': await self.get_gpu_temperature(),
'ml_performance': await self.analyze_ml_performance()
}
GuardianAgent provides multi-layer security:
# Challenge-response authentication
challenge = guardian.generate_challenge()
response = agent.sign_challenge(challenge)
authenticated = guardian.verify_response(response)
Access control validation
access_granted = guardian.validate_access(agent_id, resource, operation)
Security audit logging
guardian.log_security_event(event_type, agent_id, resource, outcome)
IDManagerAgent manages cryptographic identities:
# Ethereum-compatible wallet generation
wallet = id_manager.create_new_wallet(entity_id)
Secure message signing
signature = id_manager.sign_message(message, entity_id)
Identity verification
verified = id_manager.verify_signature(message, signature, entity_id)
Encrypted Vault Integration:
Throughout the CORE system, Professor Codephreak's contributions are evident:
The mindX CORE system represents a complete cognitive and orchestration foundation implementing:
Result: A production-ready, enterprise-grade foundation that enables autonomous Augmented Intelligence with continuous self-improvement capabilities.
© Professor Codephreak - Complete CORE Architecture Reference Organizations: github.com/agenticplace, github.com/cryptoagi, github.com/Professor-Codephreak Resources: rage.pythai.net
The definitive technical reference for the mindX CORE system with complete component analysis, data flows, integration patterns, and production deployment architecture.