Maintain memory stores

MemoryManager.curator provides maintenance operations for enabled stores. Schedule it in your application; the SDK does not discover all your users or start a recurring maintenance job.

Deduplication

This local example creates facts, invokes maintenance, and inspects the result without a model or database:

import { InMemoryStorage, MemoryManager } from "@agentium/core";

const storage = new InMemoryStorage();
const memory = new MemoryManager({ storage, summaries: false, userFacts: true });
try {
  await memory.ensureReady();
  await memory.remember("Prefers concise answers", { userId: "alice" });
  console.log(await memory.curator.deduplicate({ userId: "alice" }));
  console.log(await memory.getUserFacts()?.getFacts("alice"));
} finally {
  await storage.close();
}

UserFacts already normalizes duplicate writes. A zero deduplication count can be the correct result. The curator removes facts with duplicate normalized text; it does not infer semantic equivalence without a model.

Pruning Old Data

prune({ maxAgeDays, userId?, agentName? }) handles supported facts, decisions, and learnings. It is not an automatic retention policy for every session, graph, vector, and artifact. In v4, age pruning of learnings conservatively targets unverified extracted records; review broader deletion in application code.

Consolidation (LLM-Powered)

consolidate({ userId, model }) asks a model to merge redundant active facts. It makes provider calls and mutates data. Inspect the input records and resulting count; the implementation logs failures and can return zero, so zero does not prove a provider request succeeded.

Clear All Data

Despite its name, clearAll({ userId?, agentName? }) clears the configured user facts, profile, entities, and matching Agent decision log. It does not delete every session, procedure, correction, vector index, graph record, or external artifact. Build an explicit application deletion workflow when the requirement is to erase all data for an identity.

Scheduling Maintenance

Pass an application-owned list of authorized users to a maintenance job. StorageDriver and MongoDBStorage do not expose listUsers(). Keep overlapping jobs serialized per scope and apply a host deadline. Avoid invoking destructive maintenance from untrusted tool inputs.

Full Maintenance Example

This integration helper has no hidden scheduler or user directory. The caller owns memory, supplies the users, and decides when to run it:

import type { MemoryManager } from "@agentium/core";

export async function maintainUsers(memory: MemoryManager, userIds: readonly string[]) {
  await memory.ensureReady();
  const results = [];
  for (const userId of userIds) {
    const duplicates = await memory.curator.deduplicate({ userId });
    results.push({ userId, duplicates });
  }
  return { users: results, repaired: await memory.curator.reconcile() };
}

Reconcile (v2.5+)

reconcile() repairs missing vector entries from the key-value records for enabled learnings and corrections. It returns separate repair counts. Verify vector-store credentials and availability; this is not a generic database consistency repair or a graph migration.

Why Maintenance Matters

Track maintenance counts and errors with application telemetry. Test against disposable data before changing retention. Keep initialization and storage shutdown at the same host ownership level as the rest of the application.

Build

Agent applications

Harness runtime

Teams and workflows

Data and capabilities

Interfaces and jobs

Voice and telephony

Verify and manage

Maintain memory stores

Deduplication

Pruning Old Data

Consolidation (LLM-Powered)

Clear All Data

Scheduling Maintenance

Full Maintenance Example

Reconcile (v2.5+)

Why Maintenance Matters

​Deduplication

​Pruning Old Data

​Consolidation (LLM-Powered)

​Clear All Data

​Scheduling Maintenance

​Full Maintenance Example

​Reconcile (v2.5+)

​Why Maintenance Matters

Deduplication

Pruning Old Data

Consolidation (LLM-Powered)

Clear All Data

Scheduling Maintenance

Full Maintenance Example

Reconcile (v2.5+)

Why Maintenance Matters