memmesh-sdk

MemMesh TypeScript SDK

MemMesh is not just a store-and-recall memory layer. It is a memory + calibrated-prediction + behavior-discovery engine over a bi-temporal knowledge graph. The SDK talks to the hosted platform (app.memmesh.ai) over REST; for a zero-infra local setup, drive the same engine through the CLI + MCP server instead (see memmesh-cli).

Mental model: observe (feed raw text — the engine decides what to save) → search / buildContext (retrieve) → predict (forecast the subject's next move, with a calibrated confidence and provenance).

Step 1 — install and authenticate

npm install @thinkfleet/memory-sdk
export MEMMESH_API_KEY="mm-your-api-key"   # from app.memmesh.ai

Step 2 — initialize

import { ThinkFleetMemory } from "@thinkfleet/memory-sdk";

const memory = new ThinkFleetMemory({
  apiKey: process.env.MEMMESH_API_KEY,      // or a Cognito JWT via `token`
  // baseUrl defaults to https://app.memmesh.ai
});

Step 3 — the core loop: observe → retrieve → (predict)

Observe — the engine decides what to save

Unlike layers where you judge "is this worth saving?", you feed MemMesh raw text and its extractor (regex + structural rules + optional LLM refinement) decides. Cheap, idempotent, silent on filler.

await memory.memory.observe({
  text: "Alice is vegetarian and allergic to nuts. She books gym classes on Mondays.",
  userId: "alice",
  projectId: "myapp",
});

There are also typed intake helpers: observeImage, observeVoice, observeDocument, ingestMedia.

Retrieve — search or a full context bundle

const hits = await memory.memory.search({ query: "dietary restrictions", userId: "alice" });

// Or the synthesized, token-budgeted bundle (profile + patterns + predictions + top memories):
const ctx = await memory.context.build({ subjectKind: "user", subjectId: "alice", maxTokens: 2000 });

The moat — predict anything, with calibration + abstention

This is what a vector-recall layer cannot do. Predictions carry a calibrated confidence ("80% means 80%"), provenance (evidenceMemoryIds), and a first-class abstention ("I don't know yet" is a valid, honest answer).