Concepts

Metadata

Opaque, user-defined JSON attached to each memory.

Rules

  • Type: Record<string, unknown>
  • Optional on write
  • Never validated by the SDK
  • Never modified by the SDK
  • Returned unchanged on recall

Examples

typescripttypescript
metadata: {
  source: "notion",
  ticketId: "SUP-123",
  tags: ["billing", "stripe"],
  nested: { confidence: 0.92 },
}