connect

Create a directed edge between two memories in the knowledge graph. Edges represent relationships like relates_to, supersedes, or contradicts.

Parameters

Parameter	Type	Required	Description
from	number	Yes	Source memory ID
to	number	Yes	Target memory ID
relation	string	Yes	Edge type

Relation Types

• relates_to — General association
• supersedes — Replaces outdated knowledge
• contradicts — Conflicts with
• part_of — Component of a larger concept
• derived_from — Conclusion drawn from source
• summarized_by — Condensed version

Return Value

Confirmation with edge ID. Duplicate edges are idempotent.

Examples

Link related memories

{
  "from": 42,
  "to": 17,
  "relation": "relates_to"
}

Mark a decision as superseded

{
  "from": 55,
  "to": 42,
  "relation": "supersedes"
}

Flag a contradiction

{
  "from": 60,
  "to": 42,
  "relation": "contradicts"
}

Related Tools

• disconnect — Remove an edge
• graph — View a memory’s neighborhood
• recall — Use depth parameter to traverse edges