Sdk typescript

TypeScript SDK

Install @unisonlabs/sdk and use the complete, typed brain surface from TypeScript or Bun: context recall, ingest, documents, the knowledge graph, and actor delegation.

unison-brain

The TypeScript SDK is the reference surface - every brain operation, typed.

bun add @unisonlabs/sdk   # or npm install
import { BrainClient } from "@unisonlabs/sdk";

const brain = new BrainClient({ token: process.env.UNISON_TOKEN });
// base URL defaults to https://brain.unisonlabs.ai (override: apiUrl / UNISON_API_URL)

const ctx = await brain.context({ q: "what did we decide about auth" });
if (!ctx.weakEvidence) prompt += ctx.contextMd;

await brain.ingest({ items: [{ type: "conversation", sourceRef: "s-42", turns }] });
await brain.remember({ dump: { sessionJsonl }, source: "claude-code-session" }); // curate a session
await brain.write({ path: "/workspace/decisions/queue.md", bodyMd: "# pgmq\n…", tags: ["infra"] });

Surface map

AreaMethods
recallcontext, search, grep, get, list, listFs, readFs, neighbors
writewrite, writeDocs (batch), patchDocMeta, delete, tag, share, ingest, remember
graphentities.list/resolve/get/upsert, facts.list/about/timeline/record/correct/invalidate, links.list/create
adminreview.conflicts/resolve/merges/undo, jobs.*, status
authkeys.create/list/revoke, invitations, whoami

Acting for end users

const u1 = brain.withActor("user-001");   // isolated /private/ per actor
await u1.search("what did I say?");

Safe concurrent writes: pass expectedContentHash to write and handle the 409 conflict.

On this page