Struct CortexClient 

pub struct CortexClient { /* private fields */ }

A connected Cortex client.

Wraps the tonic gRPC client with ergonomic methods for common operations. For full proto access use the proto re-export and call CortexClient::inner.

Implementations

impl CortexClient

pub async fn connect(addr: impl Into<String>) -> Result<Self>

Connect to a running Cortex server.

addr should be a full URI, e.g. "http://localhost:9090".

pub fn inner(&mut self) -> &mut CortexServiceClient<Channel>

Expose the raw gRPC client for full proto access.

pub async fn create_node( &mut self, req: CreateNodeRequest, ) -> Result<NodeResponse>

Create a node. Returns the stored NodeResponse.

pub async fn get_node(&mut self, id: &str) -> Result<Option<NodeResponse>>

Get a node by ID. Returns None if not found.

pub async fn search( &mut self, query: &str, limit: u32, ) -> Result<SearchResponse>

Semantic similarity search. Returns scored result entries.

pub async fn search_hybrid( &mut self, query: &str, anchor_ids: Vec<String>, limit: u32, ) -> Result<Vec<HybridResultEntry>>

Hybrid search combining vector similarity with graph proximity.

anchor_ids are node IDs that anchor the graph proximity component. Pass an empty Vec for pure hybrid mode with no anchors.

pub async fn briefing(&mut self, agent_id: &str) -> Result<String>

Generate a rendered context briefing for an agent. Returns markdown text.

pub async fn traverse( &mut self, node_id: &str, depth: u32, ) -> Result<SubgraphResponse>

Graph traversal starting from node_id up to depth hops.

pub async fn create_edge( &mut self, from_id: &str, to_id: &str, relation: &str, ) -> Result<String>

Create an edge between two nodes. Returns the edge ID.

pub async fn stats(&mut self) -> Result<StatsResponse>

Get graph statistics.