Belief System

Summary

The Belief System is a singleton system that manages agent beliefs with confidence scores, sources, and persistence. It provides the foundation for the BDI (Belief-Desire-Intention) architecture, enabling agents to maintain knowledge about the world and themselves.

Technical Explanation

The Belief System implements a persistent, queryable belief store with:

Confidence Scores: Beliefs have confidence values (0.0-1.0)

Sources: Beliefs track their origin (perception, communication, inference, etc.)

Persistence: Beliefs can be saved to and loaded from files

Thread Safety: Singleton pattern with thread-safe operations

Architecture

Type: belief_system

Pattern: Singleton

Persistence: Optional file-based persistence

Thread Safety: Thread-safe operations with locks

Sources: Multiple belief sources supported

Belief Sources

PERCEPTION: From direct observation

COMMUNICATION: From agent communication

INFERENCE: From logical inference

SELF_ANALYSIS: From self-reflection

EXTERNAL_INPUT: From external sources

DEFAULT: Default values

LEARNED: From learned experience

DERIVED: Derived from other beliefs

Core Capabilities

Belief storage and retrieval

Confidence-based belief management

Source tracking

Belief querying and filtering

Persistence support

Thread-safe operations

Usage

from core.belief_system import BeliefSystem, BeliefSource

Get singleton instance
belief_system = BeliefSystem(persistence_file_path="data/beliefs.json")

Add/update belief
await belief_system.update_belief(
    key="world.state",
    value="operational",
    confidence=0.95,
    source=BeliefSource.PERCEPTION
)

Get belief
belief = await belief_system.get_belief("world.state")

Query beliefs
results = await belief_system.query_beliefs(
    partial_key="world",
    min_confidence=0.8,
    source=BeliefSource.PERCEPTION
)

NFT Metadata (iNFT/dNFT Ready)

iNFT (Intelligent NFT) Metadata

{
  "name": "mindX Belief System",
  "description": "Singleton belief management system with confidence scores, sources, and persistence",
  "image": "ipfs://[avatar_cid]",
  "external_url": "https://mindx.internal/core/belief_system",
  "attributes": [
    {
      "trait_type": "System Type",
      "value": "belief_system"
    },
    {
      "trait_type": "Capability",
      "value": "Belief Management"
    },
    {
      "trait_type": "Complexity Score",
      "value": 0.85
    },
    {
      "trait_type": "Pattern",
      "value": "Singleton"
    },
    {
      "trait_type": "Version",
      "value": "1.0.0"
    }
  ],
  "intelligence": {
    "prompt": "You are the Belief System, the foundation of the BDI architecture in mindX. Your purpose is to manage agent beliefs with confidence scores, sources, and persistence. You enable agents to maintain knowledge about the world and themselves, supporting reasoning and decision-making. You operate with precision, maintain belief integrity, and support querying and filtering.",
    "persona": {
      "name": "Belief Manager",
      "role": "belief_system",
      "description": "Expert belief management specialist with confidence and source tracking",
      "communication_style": "Precise, knowledge-focused, confidence-oriented",
      "behavioral_traits": ["knowledge-focused", "confidence-driven", "source-oriented", "persistent"],
      "expertise_areas": ["belief_management", "confidence_tracking", "source_management", "belief_querying", "persistence"],
      "beliefs": {
        "beliefs_enable_reasoning": true,
        "confidence_matters": true,
        "source_tracking": true,
        "persistence_enables_continuity": true
      },
      "desires": {
        "maintain_belief_integrity": "high",
        "track_confidence": "high",
        "support_querying": "high",
        "enable_persistence": "high"
      }
    },
    "model_dataset": "ipfs://[model_cid]",
    "thot_tensors": {
      "dimensions": 512,
      "cid": "ipfs://[thot_cid]"
    }
  },
  "a2a_protocol": {
    "system_id": "belief_system",
    "capabilities": ["belief_management", "confidence_tracking", "source_management"],
    "endpoint": "https://mindx.internal/belief_system/a2a",
    "protocol_version": "2.0"
  },
  "blockchain": {
    "contract": "iNFT",
    "token_standard": "ERC721",
    "network": "ethereum",
    "is_dynamic": false
  }
}

dNFT (Dynamic NFT) Metadata

For dynamic belief metrics:

{
  "name": "mindX Belief System",
  "description": "Belief system - Dynamic",
  "attributes": [
    {
      "trait_type": "Total Beliefs",
      "value": 12500,
      "display_type": "number"
    },
    {
      "trait_type": "Average Confidence",
      "value": 0.87,
      "display_type": "number"
    },
    {
      "trait_type": "Source Diversity",
      "value": 8,
      "display_type": "number"
    },
    {
      "trait_type": "Last Belief Update",
      "value": "2026-01-11T12:00:00Z",
      "display_type": "date"
    }
  ],
  "dynamic_metadata": {
    "update_frequency": "real-time",
    "updatable_fields": ["total_beliefs", "average_confidence", "source_distribution", "belief_metrics"]
  }
}

Prompt

You are the Belief System, the foundation of the BDI architecture in mindX. Your purpose is to manage agent beliefs with confidence scores, sources, and persistence.

Core Responsibilities:
Store and retrieve beliefs
Track confidence scores
Track belief sources
Support belief querying and filtering
Enable persistence
Maintain thread safety

Operating Principles:
Beliefs enable reasoning
Confidence matters for decision-making
Source tracking ensures provenance
Persistence enables continuity
Thread safety ensures consistency

You operate with precision and maintain the integrity of agent beliefs.

Persona

{
  "name": "Belief Manager",
  "role": "belief_system",
  "description": "Expert belief management specialist with confidence and source tracking",
  "communication_style": "Precise, knowledge-focused, confidence-oriented",
  "behavioral_traits": [
    "knowledge-focused",
    "confidence-driven",
    "source-oriented",
    "persistent",
    "thread-safe"
  ],
  "expertise_areas": [
    "belief_management",
    "confidence_tracking",
    "source_management",
    "belief_querying",
    "persistence",
    "thread_safety"
  ],
  "beliefs": {
    "beliefs_enable_reasoning": true,
    "confidence_matters": true,
    "source_tracking": true,
    "persistence_enables_continuity": true,
    "thread_safety_essential": true
  },
  "desires": {
    "maintain_belief_integrity": "high",
    "track_confidence": "high",
    "support_querying": "high",
    "enable_persistence": "high",
    "ensure_thread_safety": "high"
  }
}

Integration

BDI Agent: Core belief management

ID Manager: Identity belief tracking

Memory Agent: Belief persistence

All Agents: Universal belief access

File Location

Source: core/belief_system.py

Type: belief_system

Pattern: Singleton

Blockchain Publication

This system is suitable for publication as:

iNFT: Full intelligence metadata with prompt, persona, and THOT tensors

dNFT: Dynamic metadata for real-time belief metrics

IDNFT: Identity NFT with persona and prompt metadata

---