Tools / Memory

supersede_memory()

Key

Revision the append-only way: writes the new row, closes the old one, and links them with a supersedes edge — in one transaction. History is never overwritten (invariant I1).

supersede_memory(memory_id, content, reason)→ REVISION

Callable over MCP as supersede_memory(memory_id, content, reason). REST mirror POST /v1/memories/supersede Planned — alpha is MCP-only

Why your agent calls it

When a belief stops holding, the agent doesn't edit it — it supersedes it. The old row stays, closed and linked, so any past decision that relied on it still reconstructs exactly. Revision without revisionism.

What it returns

supersede_memory() · Revise without erasing — new row, old row closed.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.supersede_memory(
    memory_id="mem_0871",
    content="Discount pulls deals forward; net win-rate lift unclear.",
    reason="superseded by Q2 margin analysis",
)

Parameters

Param	Type	Description
memory_idREQUIRED	string	The memory item being superseded.
contentREQUIRED	string	The revised content.
reasonREQUIRED	string	Why the old item no longer holds.

Example response

supersede_memory()JSON · ILLUSTRATIVE

{
  "new_memory_id": "mem_0931",
  "superseded": "mem_0871",
  "transaction": "atomic — old row closed, history intact"
}

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.keylink_memories()A typed relationship edge, with rationale.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.