continuum-memory

Continuum Memory Skill

Authoritative sources: docs/memory.md and docs/session.md.

---

Two layers

Layer	Class	Backend	Purpose
Short-term	SessionClient	Redis (port 6380)	Conversation history this session
Long-term	MemoryClient	mem0 + Qdrant or Milvus	Facts extracted across sessions

AgentRunner uses both automatically when user_id and session_id are passed.

Vector store selection

Default is Milvus. Switch via env var:

VECTOR_STORE_PROVIDER=milvus      # default — Milvus (port 19530)
VECTOR_STORE_PROVIDER=qdrant      # Qdrant (port 6333)

Milvus config:

MILVUS_HOST=localhost
MILVUS_PORT=19530
MILVUS_TOKEN=                     # for Zilliz Cloud
MILVUS_COLLECTION=orchestrator_memories

Qdrant config:

QDRANT_HOST=localhost
QDRANT_PORT=6333
QDRANT_API_KEY=                   # for Qdrant Cloud
QDRANT_COLLECTION=orchestrator_memories

---

Quick agent setup

from continuum.agent import BaseAgent
from continuum.agent.config import AgentMemoryConfig
from continuum.agent.types import MemoryScope

agent = BaseAgent(
    name="assistant",
    instructions="...",
    memory_config=AgentMemoryConfig(
        search_memories=True,
        store_memories=True,
        search_scope=MemoryScope.USER,        # ENUM, not the dataclass
        store_scope=MemoryScope.USER,
        search_limit=5,
    ),
)
resp = await runner.run(agent, "...", user_id="u1", session_id="s1")

---

Direct memory access

from continuum.memory import MemoryClient

client = MemoryClient()                       # uses env defaults

# add (fact extraction via LLM)
await client.add(
    messages=[{"role": "user", "content": "I'm vegetarian"}],
    user_id="u1",
)

# semantic search
result = await client.search("dietary preferences", user_id="u1", limit=5)
for entry in result.results:
    print(entry.memory)

# CRUD
entry = await client.get(memory_id)
all_entries = await client.get_all(user_id="u1")
await client.update(memory_id, "Updated text")
await client.delete(memory_id)
await client.delete_all(user_id="u1")         # wipe a user's memories