Memory

const { userFiles, agentMemories } = await userClient.memory.list();

{
  userFiles: MemoryFile[],                       // user-global files
  agentMemories: {                               // one group per Agent with agent-scoped memory
    agentId: string,
    agentName: string | null,                    // null if the Agent no longer exists
    files: MemoryFile[],
  }[],
}

const file = await userClient.memory.getFile({
  path: '/memories/user/index.md', // the file's path
  scope: 'user',                   // 'user' (default) or 'agent'
  agentId: 'agent_123',            // required when scope is 'agent'
});

// User-global memory (shared across all the user's Agents).
await userClient.memory.writeFile({
  path: '/memories/user/preferences.md',
  content: '- Prefers concise answers\n- Works in fintech',
});

// Agent-scoped memory (private to one Agent).
await userClient.memory.writeFile({
  scope: 'agent',
  agentId: agent._id,
  path: '/memories/agent/learnings.md',
  content: 'User responds well to bullet points.',
});

await userClient.memory.deleteFile({ path: '/memories/user/preferences.md' });

import { PersonaClient } from '@personaai/sdk';

const userClient = new PersonaClient({
  baseUrl: process.env.PERSONA_BASE_URL!,
  credential: process.env.PERSONA_CREDENTIAL!,
  externalUserId: 'user_123',
});

// Seed known facts before the user's first conversation.
await userClient.memory.writeFile({
  path: '/memories/user/preferences.md',
  content: '- Prefers concise answers\n- Works in fintech\n- Looking for internships in NYC',
});

// Read them back.
const { userFiles } = await userClient.memory.list();
console.log(userFiles.map((f) => f.path));

// Support: see what an Agent remembers about this user.
const { agentMemories } = await userClient.memory.list();
for (const group of agentMemories) {
  console.log(group.agentName, group.files.map((f) => f.path));
}