Struct PersonaGraph 

pub struct PersonaGraph { /* private fields */ }

Persona graph for managing entity relationships

Maintains a graph structure of personas and their relationships, enabling coherent persona switching across related entities.

Implementations

impl PersonaGraph

pub fn new() -> Self

Create a new empty persona graph

pub fn add_node(&self, node: PersonaNode)

Add a persona node to the graph

pub fn get_node(&self, persona_id: &str) -> Option<PersonaNode>

Get a node by persona ID

pub fn add_edge(&self, from: String, to: String, relationship_type: String)

Add an edge between two personas

pub fn get_edges_from(&self, persona_id: &str) -> Vec<Edge>

Get all edges from a persona

pub fn get_edges_to(&self, persona_id: &str) -> Vec<Edge>

Get all edges to a persona

pub fn find_related_bfs( &self, start_persona_id: &str, relationship_types: Option<&[String]>, max_depth: Option<usize>, ) -> Vec<String>

Find all related personas using BFS traversal

Traverses the graph starting from the given persona ID, following relationships of the specified types.

Arguments

• start_persona_id - Starting persona ID
• relationship_types - Optional filter for relationship types to follow
• max_depth - Maximum traversal depth (None = unlimited)

Returns

Vector of persona IDs reachable from the start persona

pub fn find_related_dfs( &self, start_persona_id: &str, relationship_types: Option<&[String]>, max_depth: Option<usize>, ) -> Vec<String>

Find all related personas using DFS traversal

Traverses the graph starting from the given persona ID, following relationships of the specified types.

Arguments

• start_persona_id - Starting persona ID
• relationship_types - Optional filter for relationship types to follow
• max_depth - Maximum traversal depth (None = unlimited)

Returns

Vector of persona IDs reachable from the start persona

pub fn get_subgraph( &self, start_persona_id: &str, ) -> (Vec<PersonaNode>, Vec<Edge>)

Get the entire subgraph starting from a persona

Returns all nodes and edges reachable from the start persona.

pub fn get_all_nodes(&self) -> Vec<PersonaNode>

Get all nodes in the graph

pub fn remove_node(&self, persona_id: &str)

Remove a node and all its edges

pub fn clear(&self)

Clear the entire graph

pub fn get_stats(&self) -> GraphStats

Get graph statistics

pub fn link_entity_types( &self, from_persona_id: &str, from_entity_type: &str, to_persona_id: &str, to_entity_type: &str, )

Link personas across entity types automatically

Creates relationships between personas based on common entity type patterns:

• user → has_orders → order
• user → has_accounts → account
• order → has_payments → payment
• user → has_webhooks → webhook
• user → has_tcp_messages → tcp_message

Arguments

• from_persona_id - Source persona ID
• from_entity_type - Source entity type (e.g., “user”, “order”)
• to_persona_id - Target persona ID
• to_entity_type - Target entity type (e.g., “order”, “payment”)

pub fn find_related_by_entity_type( &self, start_persona_id: &str, target_entity_type: &str, relationship_type: Option<&str>, ) -> Vec<String>

Find all related personas of a specific entity type

Traverses the graph to find all personas of the specified entity type that are related to the starting persona.

Arguments

• start_persona_id - Starting persona ID
• target_entity_type - Entity type to find (e.g., “order”, “payment”)
• relationship_type - Optional relationship type filter (e.g., “has_orders”)

Returns

Vector of persona IDs matching the criteria

pub fn get_or_create_node_with_links( &self, persona_id: &str, entity_type: &str, related_entity_id: Option<&str>, related_entity_type: Option<&str>, ) -> PersonaNode

Get or create a persona node and link it to related entities

This is a convenience method that creates a persona node if it doesn’t exist and automatically establishes relationships based on entity type patterns.

Arguments

• persona_id - Persona ID
• entity_type - Entity type (e.g., “user”, “order”, “payment”)
• related_entity_id - Optional related entity ID to link to
• related_entity_type - Optional related entity type

impl PersonaGraph

pub fn to_visualization(&self) -> GraphVisualization

Generate visualization data for the graph

Trait Implementations

impl Clone for PersonaGraph

fn clone(&self) -> PersonaGraph

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PersonaGraph

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

Formats the value using the given formatter.

impl Default for PersonaGraph

fn default() -> Self

Returns the “default value” for a type.