JavaScript SDK

Requirements

Node.js 18 or newer
a Memside API key

Install

npm install memside

Create a client

import { MemsideClient } from "memside";

const memside = new MemsideClient({
  apiKey: process.env.MEMSIDE_API_KEY
});

Load startup context

const startup = await memside.context.startup();
console.log(startup);

Search Memories

const results = await memside.memories.search({
  q: "weekend trip",
  limit: 5
});

console.log(results);

Get one Memory

const memory = await memside.memories.get("memory_id_here");
console.log(memory);

Create a Memory

const created = await memside.memories.create({
  text: "Weekend trip plan\nHotel confirmed. Choose activities next.",
  type: "note",
  sensitivity: "private",
  tags: ["travel", "planning"]
});

console.log(created);

Creating, updating, and deleting changes account data. Review the request before running it.

Available areas

Context:

memside.context.startup()
memside.context.resume()
memside.context.workspaceProfile()

Memories:

memside.memories.list()
memside.memories.search()
memside.memories.get()
memside.memories.getBatch()
memside.memories.create()
memside.memories.update()
memside.memories.delete()

Errors

Failed requests throw MemsideError with fields such as:

status
code
retryable
requestId
details

import { MemsideClient, MemsideError } from "memside";

try {
  await memside.memories.get("missing_id");
} catch (error) {
  if (error instanceof MemsideError) {
    console.error(error.status, error.code, error.message);
  }
}

Source

JavaScript SDK on GitHub

Next steps