SDK Reference

BrainOS is distributed as 5 npm packages. All support tree-shaking via subpath imports.

@brainos/workers

The BrainOS Worker SDK — Brain IQ routing, RL feedback loop, context assembly, adversarial verification, and self-consistency voting. The full 36-layer runtime.

terminalbash

npx brainos init

Subpath Imports

Import	Description
@brainos/workers	Full library
@brainos/workers/brain-iq	Brain IQ scalar + System-0/1/2 routing
@brainos/workers/rl	RL feedback loop + dopamine/gaba signals
@brainos/workers/research	GAIA pipeline: backward chaining + K-cap + verifier
@brainos/workers/memory	Working memory blackboard + context assembly
@brainos/workers/hooks	React hooks for Worker state

@brainos/domain-agents

Domain routing, persona system, and prompt engineering for all 27 SE-aaS domains, 11 AaaS agents, and 7 PM-aaS domains.

terminalbash

pnpm add @brainos/domain-agents

Subpath Imports

Import	Description
@brainos/domain-agents	Full library
@brainos/domain-agents/se-aas	27 SE-aaS domain executors
@brainos/domain-agents/aas	11 AaaS autonomous agent types
@brainos/domain-agents/pm-aas	7 PM-aaS domains + FSM templates
@brainos/domain-agents/routing	Brain IQ-aware cross-domain routing
@brainos/domain-agents/personas	Domain personas + prompt builders

@brainos/memory-stack

Federated knowledge, working memory, context mesh, and long-term memory retrieval. Runs on Supabase + pgvector.

terminalbash

pnpm add @brainos/memory-stack

Subpath Imports

Import	Description
@brainos/memory-stack	Full library
@brainos/memory-stack/federated	Federated knowledge L25–L29
@brainos/memory-stack/context	27-query context assembly + mesh
@brainos/memory-stack/embeddings	pgvector embeddings + retrieval
@brainos/memory-stack/persistence	Supabase repository layer

@brainos/client

Lightweight HTTP client for the BrainOS API. Works in Node.js, Deno, Bun, and browsers.

terminalbash

pnpm add @brainos/client

@brainos/mcp-server

Model Context Protocol server — exposes BrainOS AI Workers as tools in Claude Desktop and Claude Code.

terminalbash

pnpm add @brainos/mcp-server

Integration Tiers

Tier	What You Get	Dependencies
1. Cognitive Control Plane	Brain IQ routing, System-0/1/2 hierarchy, Execution Contracts — <5ms per query	None
2. Memory & Context	Working memory blackboard, 27-query context assembly, Brain Context Mesh	Supabase + pgvector
3. Service Fabric	SE-aaS (27 domains), AaaS (11 agents), PM-aaS (7 domains) — each with RL loop	Supabase + Anthropic API
4. Self-Evolution	DreamCoder tool synthesis, RLVR calibration, Strategy Bandit, Federated Causal Learning	Supabase + Anthropic API