Crate post_cortex 

post-cortex — facade meta-crate.

One dependency for the whole post-cortex stack. Re-exports the workspace member crates so callers can write use post_cortex::{ConversationMemorySystem, SystemConfig}; or reach the canonical service trait via post_cortex::PostCortexService.

Picking the right crate

Direct dependence on a single member crate is usually preferable — it scopes the build to exactly what you need:

Goal	Crate
Domain types, traits, error	post_cortex_core
gRPC client (no server)	post_cortex_proto
Custom storage backend	post_cortex_storage
Embedding engine + HNSW	post_cortex_embeddings
Full memory orchestrator	post_cortex_memory
MCP tool functions	post_cortex_mcp
Running daemon + pcx CLI	post_cortex_daemon

This facade is for end-to-end consumers (e.g. integration tests, sample apps) that want the entire surface without picking.

Re-exports

pub use post_cortex_storage as storage;

pub use post_cortex_embeddings as embeddings;

pub use post_cortex_core::proto;

Modules

core

Cross-cutting primitives shared by every post-cortex crate.

daemon

Daemon runtime (axum + tonic + rmcp + SSE). Pulled in transitively by depending on this crate; reach individual pieces under post_cortex::daemon::*. The pcx CLI binary is shipped by post-cortex-daemon directly via its [[bin]] entry — depend on that crate (not this facade) if you only want to run the daemon. HTTP daemon server for multi-client access to Post-Cortex

graph

Entity graph + GraphRAG types — petgraph-backed knowledge graph used to enrich semantic search with relationship traversal. Graph module for entity relationships and Graph-RAG enrichment

mcp

MCP tool functions. Re-exported under post_cortex::mcp so downstream callers writing custom MCP servers can embed them.

proto

Protobuf + tonic-generated wire types for post-cortex.

services

Canonical services::PostCortexService trait. Every transport (gRPC, MCP, REST) delegates to the same single implementation in post-cortex-memory. Canonical service trait for post-cortex.

session

ActiveSession and session-component types — the hot-context cache

summary

Read-only summary projection types (decisions, entities, timeline) consumed by MCP get_structured_summary and the gRPC equivalent. Summary generation and presentation types.

tools

tools::mcp::* historical path — preserved as a convenience for existing code; new callers should use mcp directly.

workspace

Workspace types — WorkspaceManager, SessionRole, the entities that group multiple sessions for cross-session search. Workspace module for organizing related sessions (e.g., microservices)

Macros

new_cache

Convenience macro for creating a cache

Structs

ConversationMemorySystem

Conversation memory system using actors and channels

MemoryServiceImpl

Canonical PostCortexService implementation backed by ConversationMemorySystem.

Pipeline

Top-level non-blocking pipeline. Owns all three queue handles and the gauge tracking total in-flight work.

PipelineConfig

Configuration for the bounded work queues.

SystemConfig

System configuration

Enums

PipelineError

Error returned when a queue submission fails.

SystemError

System-wide error type for Post-Cortex

Type Aliases

Result

Type alias for Results using SystemError