coreason-runtime 0.1.0

Kinetic Plane execution engine for the CoReason Tripartite Cybernetic Manifold
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

// Copyright (c) 2026 CoReason, Inc.
// All rights reserved.

use petgraph::graph::{DiGraph, NodeIndex};
use rayon::prelude::*;

/// A node in the Active Inference policy tree representing a state/belief projection
#[derive(Debug, Clone)]
pub struct PolicyNode {
    pub name: String,
    pub expected_free_energy: f64,
}

/// Active Inference Policy Search Tree built on petgraph
pub struct PolicySearchTree {
    pub graph: DiGraph<PolicyNode, ()>,
}

impl PolicySearchTree {
    /// Creates an empty policy tree
    pub fn new() -> Self {
        Self {
            graph: DiGraph::new(),
        }
    }

    /// Adds a policy belief node to the search tree
    pub fn add_node(&mut self, name: &str, efe: f64) -> NodeIndex {
        self.graph.add_node(PolicyNode {
            name: name.to_string(),
            expected_free_energy: efe,
        })
    }

    /// Connects two belief states representing a temporal action transition
    pub fn add_transition(&mut self, from: NodeIndex, to: NodeIndex) {
        self.graph.add_edge(from, to, ());
    }

    /// Evaluates the cumulative Expected Free Energy (EFE) of all nodes in parallel
    /// utilizing Rayon to leverage multi-threaded CPU substrates.
    pub fn evaluate_tree_parallel(&self) -> f64 {
        let raw_nodes: Vec<&PolicyNode> = self.graph.node_weights().collect();
        raw_nodes
            .par_iter()
            .map(|node| node.expected_free_energy)
            .sum()
    }
}