tes-memory

Pentatonic AI Agent SDK

Memory and observability for AI agents.
Two products on one platform (TES). One install. JavaScript & Python.

---

What's in this SDK

Two products that share one TES account, one install line, and one dashboard:

Product	What it does	When you want it
Memory	Persistent, searchable memory for your AI agent — 7-layer hybrid retrieval (BM25 + vector + KG + reranker), repo onboarding via references. Runs locally (Docker) or hosted (TES).	You want your agent to remember conversations, preferences, and codebase context across sessions.
Observability	Wrap your LLM client and capture every call — tokens, tool calls, latency, content. Events flow to TES for the dashboard, analytics, and search attribution.	You want to know what your agent is actually doing in production.

Both products are sold separately, but you can use either, both, or neither. Plugins for Claude Code and OpenClaw install everything at once if you'd rather skip the SDK glue.

Pick your path

• 🧠 I want memory in my agent → Memory
• 📊 I want to instrument my LLM calls → Observability
• 🔌 I'm using Claude Code or OpenClaw → Plugins
• 📂 I want to seed memory from my codebase or docs → Repository onboarding
• 🩺 I want to check my install → Health checks (doctor)

Table of Contents

• TES — the platform
• Memory
  • Local (self-hosted)
  • Hosted (cloud)
  • Use as a library
• Observability
  • Wrap your LLM client
  • Supported providers
• Plugins
  • Claude Code
  • OpenClaw
• Repository Onboarding (corpus ingest)
• API Reference
• Health Checks (doctor)
• Architecture

---

TES — the platform

TES (Thing Event System) is Pentatonic's account-and-events backbone. Both products in this SDK run on it: memory writes/queries land in TES, observability events stream to it, and the dashboard reads from it.

You only need a TES account if you're using hosted memory or observability (observability always sends events to TES). Local memory runs entirely on your machine and needs no TES account.

# One-time: open browser, sign in or sign up, get API keys
npx @pentatonic-ai/ai-agent-sdk login

login opens your browser at the hosted sign-in page. New users click "Sign up" to create a tenant (clientId + region + email + password). After verification the CLI writes credentials to ~/.config/tes/credentials.json (mode 0600). The Claude Code plugin, OpenClaw plugin, hooks, and corpus CLI all auto-discover this file — no manual paste step.

✓ Connected as you@example.com on tenant `your-clientid`
✓ Credentials written to ~/.config/tes/credentials.json

To check connection state later: npx @pentatonic-ai/ai-agent-sdk whoami. To point at a local TES dev instance: npx @pentatonic-ai/ai-agent-sdk login --endpoint http://localhost:8788.

(init still works as a one-major-release deprecation alias for login.)

---

Memory

Persistent, searchable memory for AI agents. Backed by a 7-layer hybrid retrieval engine — BM25 keyword (L0), core files (L1), HybridRAG orchestrator (L2), Knowledge Graph entities (L3), vector index (L4), comms-namespace vectors (L5), and a document store with cross-encoder reranker (L6). Reciprocal Rank Fusion stitches them at query time.

Same engine, same wire format (/store, /search, /forget, /store-batch, /health), two deployment modes: