ContextDB Cloud SDKs 0.1.0-alpha.2: Python and TypeScript AI Agent Memory Clients

Add persistent, action-aware memory to Python and TypeScript AI agents

ContextDB Cloud SDKs 0.1.0-alpha.2 give backend developers typed clients for remembering user context, recalling it with read-your-writes consistency, evaluating consequential actions, recording confirmations, reporting execution outcomes, and verifying deletion.

The packages are thin transports over the hosted API. They do not contain the private multi-tenant server, managed-source runtime, billing system, or enterprise control plane.

Install

Python:

pip install --pre contextdb-cloud-client==0.1.0a2

TypeScript:

npm install @contextdb/cloud@alpha

Python example: remember and immediately recall a caller preference

from contextdb_cloud_client import CloudClient

async with CloudClient(
    "https://api.contextdb.ai",
    api_key="cdb_...",
) as db:
    saved = await db.remember(
        "caller-1",
        "Tuesday morning works best",
        source="user_stated",
        idempotency_key="call-42-preference",
    )
    result = await db.recall(
        "caller-1",
        "When should I schedule the appointment?",
        min_memory_version=saved.memory_version,
        min_primary_wal_lsn=saved.primary_wal_lsn,
    )

TypeScript example: gate a consequential action

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

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

const decision = await db.evaluateAction(
  "caller-1",
  "Book the Tuesday appointment",
);

if (decision.outcome === "act") {
  // Execute in your host, then report the outcome.
}

Use cases

• AI voice agents: remember language, appointment, accessibility, and confirmed caller preferences across calls.
• Customer support agents: ground replies in prior context without treating a wish as an approved action.
• Workflow agents: link evidence, act/ask/abstain decisions, confirmations, and execution receipts.
• Privacy operations: delete one memory or a complete user partition and verify removal.

What changed in alpha.2?

• Search-oriented package pages with runnable examples and named use cases.
• Clear links between Python, TypeScript, the OpenAPI contract, hosted docs, and the open-source engine.
• Direct FAQ answers and explicit alpha limitations for developers and answer engines.
• Normalized npm package metadata and public Apache-2.0 licensing.

Links

• ContextDB Cloud documentation
• Python package on PyPI
• TypeScript package on npm
• Public client source and OpenAPI contract
• Open-source ContextDB engine

Is this production-ready?

No. The clients and hosted service are alpha, and no public availability SLA is claimed. Project keys are backend credentials and must never be embedded in browser code.

Start with the ContextDB Cloud documentation, then install the client for your backend language.