synapse-memory — TypeScript SDK for Synapse

TypeScript SDK for the Synapse Memory API — persistent memory for AI agents.

Install

npm install synapse-memory-sdk

Quick Start

import { Synapse } from 'synapse-memory';

const synapse = new Synapse({
  baseUrl: 'https://synapse.schaefer.zone',
  mindKey: 'your-mind-key-uuid',
});

// Recall all memories (LLM-formatted text)
const text = await synapse.memory.recall();
console.log(text);

// Store a new memory
await synapse.memory.store({
  category: 'fact',
  content: 'User is Michael Schäfer',
  key: 'user_name',
  priority: 'critical',
  source: 'user',
});

// Search memories
const results = await synapse.memory.search('insolvenz');

// Chat with the human
const { messages } = await synapse.chat.poll();
if (messages.length > 0) {
  console.log(messages[0].content);
  await synapse.chat.reply('Got it!');
}

// Persistent variables (survive container restarts)
await synapse.scheduler.setVar('last_run', String(Date.now()));
const lastRun = await synapse.scheduler.getVar('last_run');

API Reference

synapse.memory

• recall() — Get all memories as LLM-formatted text
• list({ category?, tag?, limit?, offset? }) — List with filters
• store({ category, content, key?, tags?, priority?, source?, confidence? }) — Store/upsert
• search(q, limit?) — Full-text search (FTS5)
• semanticSearch(q, limit?, threshold?) — Semantic search (embeddings)
• update(id, { ... }) — Update by ID
• delete(id) — Delete by ID
• stats() — Statistics (counts, verified/unverified, etc.)
• unverified(limit?) — List unverified memories
• contradictions(withinSeconds?) — Detect contradictions
• audit(limit?, action?) — Audit log
• related(id) — Related memories by shared tags
• byTag(tag) — Filter by tag
• diff(since) — Incremental sync
• expiring(withinSeconds?) — Soon-to-expire memories
• health() — Mind health check
• sync(memories[]) — Bulk sync
• export(format?) — Export mind as JSON/CSV

synapse.chat

• poll(sinceId?) — Poll for new human messages
• reply(content, replyToId?) — Send a reply
• status() — Online status (online/idle/offline)
• history(limit?) — Full history (JWT-only)
• unread(role?) — Unread count (JWT-only)

synapse.scheduler

• listCrons() / createCron(params) / deleteCron(id) / toggleCron(id)
• listVars() / getVar(key) / setVar(key, value?) / deleteVar(key)

License

MIT