@centient/sdk

TypeScript SDK for Centient -- AI agent memory and context engineering infrastructure.

Installation

npm install @centient/sdk

Or with pnpm:

pnpm add @centient/sdk

Quick Start

import { EngramClient, createEngramClient } from "@centient/sdk";

// Create client from environment variables
const client = createEngramClient();

// Or with explicit config
const client = new EngramClient({
  baseUrl: "http://localhost:3100",
  apiKey: "your-api-key",
});

// Create a session
const session = await client.createSession({
  sessionId: "2026-01-17-feature-work",
  projectPath: "/path/to/project",
  embeddingPreset: "balanced",
});

// Save notes
await client.createNote(session.id, {
  type: "decision",
  content: "Using PostgreSQL with RLS for multi-tenant data isolation",
});

// Search session memory
const results = await client.search(session.id, {
  query: "database security",
  limit: 5,
});

Features

• 13+ resource classes covering sessions, notes, crystals, entities, search, and more
• 95+ fully typed request/response interfaces
• Factory function createEngramClient() for quick setup
• Session coordination (constraints, decision points, branches)
• Knowledge crystal management with hierarchy and versioning
• Entity extraction and graph queries
• Real-time event streaming
• Export/import with conflict resolution

Documentation

• Optimistic concurrency (CAS) — using expectedVersion on crystals.update to prevent lost writes under concurrent mutation.
• Skip-embedding optimization — using skipEmbedding on crystals.update to reclaim LLM compute on high-frequency status updates (heartbeats, counters, lock holders).
• Full monorepo docs — architecture, ADRs, and cross-package guides.

License

MIT