Recall Quickstart for TypeScript

pnpm add @arc-labs/recall
# or: npm install @arc-labs/recall
# or: yarn add @arc-labs/recall

import { Recall } from "@arc-labs/recall";

const recall = new Recall({
  store: { type: "sqlite", path: "./recall.db" },
  // For production:
  // store: { type: "postgres", url: process.env.DATABASE_URL },
});

await recall.write({
  scope: { user_id: "u_alice" },
  source: {
    turn: {
      user: "I prefer dark mode in my IDE — light themes hurt my eyes.",
      assistant: "Noted — I'll default to dark mode for editor recommendations.",
    },
  },
});

// The 7-stage pipeline runs:
// pre-filter → extract → classify → resolve → dedupe → conflict → persist
// Result: 1 preference stored ("user prefers dark mode in IDE", confidence 0.93)

const results = await recall.search({
  scope: { user_id: "u_alice" },
  query: "what theme should I use?",
  limit: 10,
});

console.log(results[0]);
// {
//   id: "mem_01H...",
//   type: "preference",
//   content: "user prefers dark mode in IDE",
//   confidence: 0.93,
//   score: 0.91,
//   freshness: 1.0,
// }

const ctx = await recall.context({
  scope: { user_id: "u_alice" },
  query: userMessage,
  budget: 1500, // tokens
});

// ctx.render("structured") produces:
// memories.preferences:
//   - [mem_01H...] user prefers dark mode in IDE (conf 0.93)
// memories.facts: []

const response = await openai.chat.completions.create({
  model: "gpt-4.1",
  messages: [
    {
      role: "system",
      content: `You have these memories about the user:\n${ctx.render("structured")}`,
    },
    { role: "user", content: userMessage },
  ],
});

import type { Memory, MemoryType, RecallError } from "@arc-labs/recall";

// All types are exported and stable across versions.
function describeMemory(m: Memory): string {
  switch (m.type) {
    case "preference":
      return `User prefers ${m.content}`;
    case "fact":
      return `Fact: ${m.content}`;
    case "event":
      return `Event on ${m.timestamp}: ${m.content}`;
    // exhaustive — TS will flag if you forget a case
  }
}