TypeScript SDK

@cognimemo/client — the official TypeScript / JavaScript client.

npm install @cognimemo/client

Quickstart

import { CognimemoClient } from "@cognimemo/client";

const cm = new CognimemoClient({ baseUrl: "https://api.cognimemo.com", apiKey: "cmk_live_…" });

await cm.retain("jane@acme.com", "Jane ships on Fridays.");

const res = await cm.recall("jane@acme.com", "when does Jane ship?");
res.results.forEach((r) => console.log(r.type, r.text, r.scores));

const answer = await cm.reflect("jane@acme.com", "What is Jane's release cadence?");

Data model — space → bank → memories

await cm.createSpace("acme", { name: "Acme Corp" });
await cm.retain("jane@acme.com", "Jane prefers dark mode", { space: "acme" });
await cm.recall("jane@acme.com", "what does jane prefer?", { space: "acme" });
await cm.listSpaceBanks("acme");

Typed memory blocks

await cm.retainPreference("jane@acme.com", "For day-planning, use personal Gmail, never work mail.");
await cm.retainProcedure("jane@acme.com", ["make build", "kubectl apply -f prod.yaml"], { rationale: "prod deploy" });
await cm.retainReasoning("jane@acme.com", "Chose gRPC over REST: p99 latency mattered more.");
await cm.retainCorrection("jane@acme.com", "No — drain the pod before restart.");
await cm.updateProfile("jane@acme.com", "Admin on AWS, GitHub, Grafana.");

// any type directly:
await cm.retain("jane@acme.com", "Acme HQ is in Berlin.", { factType: "world" });

// type-filtered recall:
await cm.recall("jane@acme.com", "how to deploy", { types: ["procedure"] });

See Typed memory blocks for the full list.

Layered / org memory

await cm.retain("__org__:acme", "Deploy freeze every December.");
await cm.recallLayered("jane@acme.com", "deploy policy", { space: "acme" });

Entities

await cm.retain("jane@acme.com", "Jane joined the DeepMind team on Gemini.", {
  entities: [{ text: "Jane", type: "PERSON" }, { text: "Gemini", type: "PROJECT" }],
});

// no-LLM auto-entities for verbatim ingest (off by default):
await cm.updateBankConfig("jane@acme.com", { retainAutoEntities: true });

Encryption at rest

await cm.enableEncryption("jane@acme.com");   // encryption: "managed"; recall stays transparent
await cm.disableEncryption("jane@acme.com");

Recall response

recall(...) resolves to a RecallResponse with .results (each a RecallResult) and .usage. Each result carries type, text, context, occurred_start / occurred_end / mentioned_at, entities, and scores ({ final, semantic, keyword }). .usage includes tokens_used and org_blended for layered recall.