Tools / Memory

link_memories()

Key

Creates a typed relationship edge between two memory items — supports, contradicts, refines — with the rationale recorded on the edge.

link_memories(from_id, to_id, relation, rationale)→ EDGE

Callable over MCP as link_memories(from_id, to_id, relation, rationale). REST mirror POST /v1/memories/link Planned — alpha is MCP-only

Why your agent calls it

When the agent notices structure — this lesson supports that belief, this fact contradicts that assumption — it records the relationship explicitly, with the reasoning on the edge. Retrieval gets smarter every time.

What it returns

link_memories() · A typed relationship edge, with rationale.ILLUSTRATIVE

Call it from an agent

Over MCP, your agent invokes it on its own when the moment calls for it — just describe the situation. A Python SDK for headless runtimes is planned; this is what the call will look like.

agent · python sdkSDK · PLANNED — ALPHA IS MCP-ONLY

from cascadian import Cascadian

cx = Cascadian(api_key=os.environ["CASCADIAN_API_KEY"])

result = cx.link_memories(
    from_id="mem_0912",
    to_id="mem_0871",
    relation="contradicts",
    rationale="Margin data shows the tier is net-negative.",
)

Parameters

Param	Type	Description
from_idREQUIRED	string	Source memory id.
to_idREQUIRED	string	Target memory id.
relationREQUIRED	string	The typed relation, e.g. "contradicts".
rationaleREQUIRED	string	Why this edge exists.

Example response

link_memories()JSON · ILLUSTRATIVE

{
  "edge_id": "lnk_0118",
  "relation": "contradicts",
  "status": "proposed"
}

Related — Memory

keybootstrap()The ~200-token session card your agent reads first.keyingest_source()Store a raw source — chunked, embedded, indexed.keyassert_fact()Write a temporal fact with an honest available_at.keypropose_memory()Propose a memory item — contradiction-checked on write.keysupersede_memory()Revise without erasing — new row, old row closed.keysearch_memory()Hybrid retrieval with an honest empty result.keyget_facts()What was true, as of any moment.keyget_entity()The versioned dossier for one entity.keyget_memory()The full evidence card, by id.keyget_context_pack()Everything knowable for a decision, stamped and typed.keylist_contradictions()Open conflicts waiting on a human.