Memory Types

Reference for all memory-related types — MemoryStore, MemoryEntry, MemoryMetadata.

MemoryStore Interface

interface MemoryStore {
  add(entry: Omit<MemoryEntry, 'id' | 'createdAt'>): Promise<string>;
  search(query: MemoryQuery): Promise<MemorySearchResult[]>;
  get(id: string): Promise<MemoryEntry | null>;
  delete(id: string): Promise<void>;
  clear(namespace?: string): Promise<void>;
}

MemoryEntry

interface MemoryEntry {
  id: string;
  content: string;
  metadata: MemoryMetadata;
  namespace?: string;
  embedding?: number[];
  createdAt: number;
}

MemoryMetadata

interface MemoryMetadata {
  type?: string;
  source?: string;
  tags?: string[];
  [key: string]: unknown;
}

MemoryQuery

interface MemoryQuery {
  query: string;
  namespace?: string;
  limit?: number;
  minScore?: number;
  metadata?: Record<string, unknown>;
}

MemorySearchResult

interface MemorySearchResult {
  entry: MemoryEntry;
  score: number;
}

MemoryProvider

type MemoryProvider = 'memory' | 'pgvector';

Next Steps

Overview — memory architecture
Configuration — agent memory config

Cleanup

Manage memory lifecycle with MemoryCleanupManager — TTL, limits, and scheduled cleanup.

Budget Governor

Control agent costs with BudgetGovernor — token limits, cost caps, and warning thresholds.