search), Brain is company-specific and private: policies, docs, past decisions, product info. It is Naive-owned end to end — the canonical source of truth lives in a Postgres “spine” (documents, chunks, episodes, claims, provenance) with a semantic engine (GBrain) projected on top for richer recall. Reads degrade gracefully to the spine when the engine is unavailable, and deletion is provable.
Brain is an opt-in primitive. It’s disabled by default on new companies. Enable it in the AccountKit’s
primitives_config (dashboard → Account Kits, or the kit’s brain: { enabled: true }) before use, or calls return 403 primitive_disabled_by_kit.Two layers: documents and semantic memory
Both live in the same company-scoped knowledge base. A company gets a default “Default Brain” KB provisioned lazily on first use; you can create additional named KBs.
CLI first
Credits
Plan-quota metering also applies per tenant for the
brain primitive (across HTTP, SDK, and MCP).
Grounded answers with citations
query returns an answer plus citations that map back to your ingested documents. Citations are scoped to the calling company and knowledge base — a citation that can’t be mapped to one of your documents is dropped, so answers never leak another tenant’s sources.
session_id back to query/think to continue the same conversation thread.
Governance and deletion
- Approval-gated destruction. Deleting a knowledge base, deleting a document, and
forgetare approval-gated for agent (API-key) callers: the call returns202with a pending approval that an owner approves. Session owners execute immediately. - Provable deletion. Deletes are provider-first and return a
DeletionReceiptdistinguishingprovider_confirmed(the purge ran) fromverified(post-purge emptiness was confirmed). Tombstones prevent forgotten data from resurfacing through the async semantic projection. - Memory Gateway. Agent-produced memory can be routed through a proposal → review → promotion pipeline (
shadow/proposal/enforcedmodes) so canonical company memory is never silently mutated. Review proposals in Mission Control.
Interfaces
Brain is available across every surface:- API —
/v1/brain/*(and per-user/v1/users/:id/brain/*). See the Brain API reference. - SDK —
naive.brain.*. See the brain sub-client. - CLI —
naive brain .... See the CLI reference. - MCP — 15
naive_brain_*tools for agents. See MCP brain tools.