# jido_gralkor v3.0.0 - Table of Contents

> Jido plugin and actions that adapt the Gralkor memory server into a Jido agent. Drop in the plugin for recall-on-query and capture-on-completion; add the actions to your ReAct tools list for explicit memory_search / memory_add.

## Pages

- [jido_gralkor](readme.md)

## Modules

- [Gralkor.CaptureBuffer](Gralkor.CaptureBuffer.md): In-flight conversation buffer keyed by `session_id`.
- [Gralkor.Client](Gralkor.Client.md): Port for talking to a Gralkor backend from Elixir.
- [Gralkor.Client.InMemory](Gralkor.Client.InMemory.md): In-memory twin of `Gralkor.Client` for tests.
- [Gralkor.Client.Native](Gralkor.Client.Native.md): Production `Gralkor.Client` implementation. In-process — no HTTP — talks
to graphiti via `Gralkor.GraphitiPool` (Pythonx-backed) and to the LLM via
`req_llm` (Elixir-side, used by `Gralkor.Distill` and `Gralkor.Interpret`).
- [Gralkor.Config](Gralkor.Config.md): Configuration for the embedded Gralkor runtime.
- [Gralkor.Distill](Gralkor.Distill.md): Render a list of conversation turns into an episode body suitable for
ingesting into the knowledge graph.
- [Gralkor.Format](Gralkor.Format.md): Format graphiti edge data into the canonical fact strings the LLM sees.
- [Gralkor.GraphitiPool](Gralkor.GraphitiPool.md): Per-group Graphiti instance cache, plus the gateway for graphiti operations.
- [Gralkor.Interpret](Gralkor.Interpret.md): Filter retrieved graph facts down to those relevant to the conversation,
using the configured LLM.
- [Gralkor.Message](Gralkor.Message.md): Canonical message shape that Gralkor expects at its port boundary.
- [Gralkor.Python](Gralkor.Python.md): PythonX runtime owner for the embedded Gralkor stack.
- [Gralkor.Recall](Gralkor.Recall.md): Orchestrate one recall call: search the graph, interpret the hits against
the buffered conversation, wrap the result in a `<gralkor-memory>` block.
- [JidoGralkor.Actions.MemoryAdd](JidoGralkor.Actions.MemoryAdd.md): ReAct tool the LLM can call to store a thought or decision in memory.
- [JidoGralkor.Actions.MemoryBuildCommunities](JidoGralkor.Actions.MemoryBuildCommunities.md): Admin tool that runs Graphiti's community detection over this agent's
memory partition.
- [JidoGralkor.Actions.MemoryBuildIndices](JidoGralkor.Actions.MemoryBuildIndices.md): Admin tool that rebuilds Gralkor's graph search indices.
- [JidoGralkor.Actions.MemorySearch](JidoGralkor.Actions.MemorySearch.md): ReAct tool the LLM can call to search long-term memory.
- [JidoGralkor.Canonical](JidoGralkor.Canonical.md): Converts a Jido/ReAct turn into Gralkor's canonical message shape.
- [JidoGralkor.ContextRotator](JidoGralkor.ContextRotator.md): Memory consolidation for a long-lived Jido agent.
- [JidoGralkor.Lifecycle](JidoGralkor.Lifecycle.md): `Jido.AgentServer.Lifecycle` implementation that flushes the active
Gralkor session when an agent process terminates.
- [JidoGralkor.Plugin](JidoGralkor.Plugin.md): Jido plugin that replaces `Jido.Memory.BasicPlugin` with Gralkor-backed
memory. Claims the `:__memory__` slot so it is the only memory plugin
attached to the agent.
- [JidoGralkor.ReAct](JidoGralkor.ReAct.md): Helpers for `Jido.AI.Reasoning.ReAct` consumers that want Gralkor-aware
request shaping.

- Exceptions
  - [Gralkor.InterpretParseFailed](Gralkor.InterpretParseFailed.md): Raised when the LLM's interpret response cannot be parsed against the
structured-output schema — typically because `:output_token_budget` was too
small and the model's answer truncated mid-list, but also for any other
schema mismatch.