Struct AinlMemoryNode 

pub struct AinlMemoryNode {
    pub id: Uuid,
    pub memory_category: MemoryCategory,
    pub importance_score: f32,
    pub agent_id: String,
    pub project_id: Option<String>,
    pub node_type: AinlNodeType,
    pub edges: Vec<AinlEdge>,
    pub plugin_data: Option<Value>,
}

A node in the AINL memory graph

Fields

id: Uuid

memory_category: MemoryCategory

importance_score: f32

agent_id: String

project_id: Option<String>

Optional host workspace / repo key (when AINL_MEMORY_PROJECT_SCOPE is enabled).

node_type: AinlNodeType

edges: Vec<AinlEdge>

plugin_data: Option<Value>

Freeform extension payload for host-specific metadata that doesn’t fit a typed variant. Stored alongside the node payload; ignored by the core runtime.

Implementations

impl AinlMemoryNode

pub fn new_episode( turn_id: Uuid, timestamp: i64, tool_calls: Vec<String>, delegation_to: Option<String>, trace_event: Option<Value>, ) -> Self

Create a new episode node

pub fn new_fact(fact: String, confidence: f32, source_turn_id: Uuid) -> Self

Create a new semantic fact node

pub fn new_pattern(pattern_name: String, compiled_graph: Vec<u8>) -> Self

Create a new procedural pattern node

pub fn new_procedural_tools( pattern_name: String, tool_sequence: Vec<String>, confidence: f32, ) -> Self

Procedural node from a detected tool workflow (no compiled IR).

pub fn new_persona( trait_name: String, strength: f32, learned_from: Vec<Uuid>, ) -> Self

Create a new persona trait node

pub fn new_trajectory( trajectory: TrajectoryNode, agent_id: impl Into<String>, ) -> Self

Create a trajectory node linked to an episode graph row (episode_id = episode node’s id).

pub fn new_loop_guard_failure( verdict_label: &str, tool_name: Option<&str>, message: impl Into<String>, session_id: Option<&str>, ) -> Self

Failure node from the agent loop loop-guard (verdict_label: block | circuit_break).

pub fn new_tool_execution_failure( tool_name: &str, message: impl Into<String>, session_id: Option<&str>, ) -> Self

Failure node from a host tool execution error (OpenFang tool_runner, MCP dispatch, etc.).

source is fixed to tool_runner:error for FTS recall alongside loop-guard failures.

pub fn new_tool_execution_failure_with_source( tool_name: &str, message: impl Into<String>, session_id: Option<&str>, source_namespace: Option<&str>, source_tool: Option<&str>, ) -> Self

Like Self::new_tool_execution_failure, with optional MCP-style source metadata for analytics / recall.

pub fn new_agent_loop_precheck_failure( kind: &str, tool_name: &str, message: impl Into<String>, session_id: Option<&str>, ) -> Self

Failure node for tool calls rejected in the agent loop before execute_tool (hooks, required-parameter validation, etc.). kind becomes agent_loop:{kind} in FailureNode::source (e.g. hook_blocked, param_validation) for FTS recall alongside tool_runner:error.

pub fn new_ainl_runtime_graph_validation_failure( message: impl Into<String>, session_id: Option<&str>, ) -> Self

Failure node when ainl-runtime rejects a turn because the loaded graph fails validation (dangling edges, etc.). Fixed source for FTS recall with other failure origins.

pub fn episodic(&self) -> Option<&EpisodicNode>

pub fn semantic(&self) -> Option<&SemanticNode>

pub fn procedural(&self) -> Option<&ProceduralNode>

pub fn persona(&self) -> Option<&PersonaNode>

pub fn trajectory(&self) -> Option<&TrajectoryNode>

pub fn failure(&self) -> Option<&FailureNode>

pub fn add_edge(&mut self, target_id: Uuid, label: impl Into<String>)

Add an edge to another node

Trait Implementations

impl Clone for AinlMemoryNode

fn clone(&self) -> AinlMemoryNode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AinlMemoryNode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AinlMemoryNode

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AinlMemoryNode

fn eq(&self, other: &AinlMemoryNode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AinlMemoryNode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AinlMemoryNode