@contextdb/cloud

ContextDB Cloud TypeScript SDK for AI agent memory

Give Node.js voice, support, and workflow agents persistent memory through the hosted ContextDB data plane.

npm install @contextdb/cloud

import { CloudClient } from "@contextdb/cloud";

const db = new CloudClient({
  baseUrl: "https://api.contextdb.ai",
  apiKey: process.env.CONTEXTDB_API_KEY!,
});

const saved = await db.remember(
  "caller-1",
  "Thursday works",
  { source: "user_stated" },
);

Project API keys are server credentials. Do not expose them to browser code. The package is marked server-only and throws if constructed in a browser runtime. Use it from Node.js servers, API routes, workers, or server actions.

Use cases

• Remember caller preferences across Retell, LiveKit, Pipecat, or custom voice agent sessions.
• Ground support responses in previous conversations.
• Require an act/ask/abstain decision before consequential tools run.
• Pass consistency tokens when a follow-up recall must observe a recent write.
• Report execution receipts for an auditable memory-to-action timeline.

Links

• ContextDB API documentation
• Source and OpenAPI contract
• Python SDK
• Open-source ContextDB engine
• Release notes

Is this package production-ready?

The package is alpha. It contains no ContextDB Cloud server implementation. No public availability SLA is claimed.