SDK overview - BMA Developer Docs

BMA has three client surfaces and two SDKs of its own. Most apps need only the first row.

	Anthropic SDKs	bma-sdk	bma-executor-sdk
You are	An app that runs agents	An app that runs agents and needs BMA-only features	A machine (hand) or an agent loop (brain) that BMA drives
Talks to	Managed Agents API `/v1`	Native REST API `/api/v1` and the BMA extensions on `/v1`	Executor Protocol `bma.executor.v1.1` (JSON-RPC 2.0 over WebSocket)
Responsibilities	agents, environments, sessions, events, files, memory stores	Everything in the native API (orgs, projects, agent configs and profiles, sessions, inputs, events and SSE, interactions, artifacts, project files, machines, pools, backups, terminal and desktop sessions, secrets, models, skills); typed helpers for the `/v1` extensions	Executor end (register, heartbeat, reconnect, tool calls, processes, MCP channel, artifact upload), harness end (drive executors), agent capability (both sides)
Does not do	BMA extensions (desktop tickets, session files, `bma_sequence`)	The standard `/v1` routes: use the Anthropic SDKs for those	Calling the REST API; the agent loop itself
Credential	Org API key (`x-api-key`)	Org or personal API key (`Bearer`)	Environment key or machine token, exchanged for a 5-minute JWT
Languages	Python, TypeScript, Go, and the other official SDKs	Go, TypeScript, Python	Go (reference), TypeScript, Python
Status	Available	Available	Executor and harness ends: Available (early access). Agent capability: Preview.

Packages and versions

Both SDK repositories release all three languages from one tag. Versions as published on 2026-11-04:

SDK	Language	Package	Version	Runtime
bma-sdk	Go	`github.com/beeos-ai/bma-sdk` (`rest`, `facadeext`)	v0.4.2	Go 1.24+
bma-sdk	TypeScript	`@beeos-ai/bma-sdk` (`.` and `./facade-extensions`)	0.4.2	Node.js 20+, ESM
bma-sdk	Python	`bma-sdk` (`bma_sdk`)	0.4.1 on PyPI (0.4.2 tagged, not yet published)	Python 3.10+
bma-executor-sdk	Go	`github.com/beeos-ai/bma-executor-sdk` (package `bmaexecutor`)	v0.4.9	Go 1.24+
bma-executor-sdk	TypeScript	`@beeos-ai/bma-executor-sdk`	0.4.9	Node.js 20+, ESM
bma-executor-sdk	Python	`bma-executor-sdk` (`bma_executor_sdk`)	0.4.8 on PyPI (0.4.9 tagged, not yet published)	Python 3.10+

Both SDKs are Apache-2.0, generated from machine-readable contracts checked into each repository (contracts/bma/), and tested in all three languages against the same recorded fixtures or conformance examples.

Which one do I need?

Language parity

Capability	Go	TypeScript	Python
bma-sdk: native REST client (every operation)	✅ `rest` (oapi-codegen)	✅ `bma.rest` (openapi-fetch)	✅ `bma_sdk.rest` (sync + asyncio)
bma-sdk: SSE stream and verified artifact download	✅	✅	✅
bma-sdk: `/v1` extensions (desktop ticket, session files and resources)	✅ `facadeext`	✅ `facade-extensions`	✅ `facade_extensions`
executor: executor end	✅	✅	✅ (asyncio)
executor: execution `Core` (bash, file tools, stdio MCP)	✅	—	—
executor: `process.*` / `skill.install` helpers	✅	— (`onRequest`)	— (`on_request`)
executor: harness end	✅	✅	✅
executor: agent capability (both sides)	✅	✅	✅
executor: executor listens on a local socket	✅	✅	—

bma-sdk

Install, authenticate, native REST, and the /v1 extensions

bma-executor-sdk

Executors, harnesses, and the agent capability