Knowledge graphs that
know when to think

Graphonomous is a continual learning memory engine for AI agents. It stores knowledge as a graph, detects circular dependencies via the κ invariant, and tells your agent when to retrieve and when to deliberate.

v0.1.12 · Elixir/OTP · MCP Server · Apache 2.0

The κ routing demo

The system analyzed a 4-node business cycle and made the routing decision automatically. This is the proof that κ-aware topology routing works end-to-end on live MCP calls.

DAG Region (κ = 0)

routing:    fast
max_kappa:  0
action:     Single-pass retrieval.
            No deliberation needed.

SCC Region (κ > 0)

routing:    deliberate
max_kappa:  1
scc_count:  1
fault_line: Product Quality → Market Share
budget:     max_iterations: 2, agents: 1,
            confidence: 0.75
MCP Tool: analyze_topology — Input: 4 business cycle nodes
{
  "routing": "deliberate",
  "max_kappa": 1,
  "scc_count": 1,
  "sccs": [{
    "id": "scc-0",
    "nodes": ["market-share", "revenue", "r-and-d", "product-quality"],
    "kappa": 1,
    "approximate": false,
    "fault_line_edges": [{
      "source": "product-quality",
      "target": "market-share"
    }],
    "routing": "deliberate",
    "deliberation_budget": {
      "max_iterations": 2,
      "agent_count": 1,
      "timeout_multiplier": 1.5,
      "confidence_threshold": 0.75
    }
  }],
  "dag_nodes": []
}

Live result from Graphonomous MCP server. The system detected a circular dependency between market share, revenue, R&D, and product quality — and identified the exact edge (Product Quality → Market Share) where the feedback loop is weakest. No other agent memory system does this.


How it works

Store

Agents store episodic, semantic, and procedural knowledge as typed graph nodes with confidence scores and provenance. Edges capture causal, temporal, and associative relationships.

Analyze

On every retrieval, Graphonomous computes the topological structure of the relevant subgraph. Tarjan's SCC algorithm detects circular dependencies. The κ invariant measures entanglement depth.

Route

κ = 0 → fast retrieval (single pass, no LLM call). κ > 0 → deliberate (decompose along fault lines, reason through partitions, write conclusions back). The graph tells the agent how to think.


Available tools

Tool Description
store_node Persist knowledge nodes with type, confidence, metadata
retrieve_context Semantic search + neighborhood expansion + topology annotations
analyze_topology Compute SCCs, κ values, routing decision, fault-line edges
learn_from_outcome Update confidence across causal chains from grounded outcomes
query_graph List, filter, similarity search across the graph
manage_goal Goal lifecycle — create, transition, link nodes
review_goal Inspect goal state, coverage, progress
run_consolidation Trigger decay, prune, merge cycle

What makes this different

Every agent memory system retrieves context. Graphonomous is the only one that tells you the shape of what you retrieved.

  • Mem0 stores facts with smart updates. It doesn't detect circular dependencies.
  • Zep / Graphiti builds temporal knowledge graphs. It doesn't route inference based on topology.
  • Letta (MemGPT) pages memory in and out of context. It doesn't know when context is tangled.

Graphonomous computes κ — a proved graph-theoretic invariant — on every retrieval. When your knowledge has feedback loops, the system tells you exactly where they are and how to reason through them.


Under the hood


Proved theory

The κ invariant is proved on 1,926,351 finite systems with zero counterexamples. The proof is browser-runnable at opensentience.org.

The theoretical foundations, deliberation protocol, attention engine, and governance model are published as open research protocols OS-001 through OS-006.

OpenSentience · Ampersand Box Design · [&] Protocol Spec