memory_graph
Reads the association edges around given concepts: which concepts the memory has linked together, with each link's weight, outcome valence and co-activation count. Use to inspect what a memory store has learned or to explain why a read expanded to a concept. Read-only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Hops to expand from the seeds (1-3, default 1). At depth 2 or 3, if min_weight is omitted the engine floors edge weight at 0.05 at EVERY hop — including the first — so a hub concept cannot fan out across the whole store before limit applies; pass min_weight explicitly (0 included) to see every edge anyway. | |
| limit | No | Max edges to return (1-500, default 100 — mirrors memory_read's top_k bounds). | |
| seeds | Yes | Concepts to center the graph on (1-20, each ≤200 chars, non-blank) — e.g. ['deploy', 'staging']. An unrecognised concept simply contributes no edges; it is not an error. | |
| domain | No | Read a shared room's graph instead of your own: pass that room's address (e.g. 'xroom:room_01ABC'). Find room addresses with memory_list_rooms. Unlike memory_read, any OTHER value has no effect here — the association store has no domain column, so a plain domain name behaves exactly like omitting this field. | |
| min_weight | No | Only include edges at or above this weight (≥ 0). Omit for no floor at depth 1; at depth 2/3 the engine applies its own 0.05 floor when this is omitted (see depth) — pass 0 to see every edge at every depth. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| edges | Yes | Association edges found within the requested depth. | |
| nodes | Yes | Concepts touched by edges below. A seed with no surviving edge (unrecognised concept, or every edge fell below the weight floor) is not listed. | |
| truncated | Yes | True when a per-hop server cap or limit cut the walk short — the store may hold more edges than are reported here. | |
| min_weight_applied | Yes | The weight floor actually used at every hop: your min_weight when you set one (0 included); otherwise 0.05 from depth 2, or 0 at depth 1. |