Quickstart

npm install @xtraceai/memory

import { MemoryClient } from '@xtraceai/memory';

const client = new MemoryClient({
  apiKey: process.env.XTRACE_API_KEY!,
  orgId:  process.env.XTRACE_ORG_ID!,
});

const job = await client.memories.ingest({
  messages: [
    { role: 'user', content: 'My favorite food is pad see ew. I love Thai cuisine.' },
    { role: 'assistant', content: 'Got it — pad see ew noted.' },
  ],
  user_id: 'alice',
  conv_id: 'conv_2026_05_16',
});

console.log('Ingest job:', job.id, 'status:', job.status);

const done = await client.memories.jobs.pollUntilDone(job.id);
console.log('Memories created:', done.result?.memories_created);

const results = await client.memories.search({
  query: 'what does the user like to eat?',
  user_id: 'alice',
  limit: 5,
});

for (const m of results.data) {
  console.log(m.score?.toFixed(2), '·', m.text);
}
// 0.87 · User loves Thai cuisine.
// 0.82 · User's favorite food is pad see ew.