Scopes

Scopes decide what memory can be written and retrieved.

Rules that avoid bugs

• Use stable IDs from your application.
• Do not let the browser invent tenant scope.
• Keep project names consistent between write and search.
• Use session scope when the same user has multiple independent conversations.
• Use agent and task scope for multi-agent workflows.

User chat example

const user = db.user("user_123");
const session = user.session("chat_456");

await session.remember("User is debugging billing webhooks.");
const { context } = await session.getContext("What are we debugging?");

Agent task example

const task = db.agent("planner").task("checkout-redesign");

await task.event({
  type: "decision",
  summary: "Use hosted checkout for the first release."
});

Next: Agent Memory Bus.